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Notice 


Copyright 


Copyright 1985 by IDEAssociates, Inc. 
All rights reserved. 


Trademarks 


IBM is a registered trademark of 
International Business Machines. 


IDEAcomm 3278 is a trademark of 
IDEAssociates Incorporated. 


IRMA is a trademark of Digital 
Communications Associates, Inc. 


Documentation 


IDEAssociates has made every effort to 
ensure accuracy of this manual. We 
welcome your comments and corrections. 
(See the Customer Survey card in this 
manual.) However, IDEAssociates 
specifically disclaims any implied 
warranties or merchantability of the 
contents of this manual, and shall not 
be liable for errors contained in it. 


vil 


IDEAssociates has an established 
network of computer dealers throughout 
the United States and Europe. To place 
an order or to locate the nearest 
_,dealer, call | -nationwide at (800) 
257-5027. 
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Overview 


The IDEAcomm 3278 is a communications 
card that emulates an IBM 3278 or 3279 
terminal. It supplies users with all 
the functionality of an IBM PC, plus 
access to mainframe information and 
applications. IDEAcomm 3278 also 
provides a file transfer program that 
allows the user to transfer files in 
both directions. 


The IDEAcomm 3278 is connected to the 
IBM 3274/3276 via a coax cable. The 
-IDEAcomm 3278 supports Bisync and | 
SNA/SDLC protocols, and its features 
include: 


oO support of 3278-2, 3279 S2A and Bee 
terminals 


O coax connection to: 


IBM 3274 controller with type "A" 
adapters, SNA/SDLC or BSC 


IBM 3276 remote terminal controller, 
SNA/SDLC or BSC 


Xvii 


advanced file transfer in TSO and 
vM/CMS environments. (One keystroke 
uploads or downloads files from the 
mainframe.) 


compatible with mainframe software 
packages that support either of the 
following interfaces: 


IDEA Native Mode (software written 


for the IDEA high performance Native 
interface) 


IRMA Mode (software written for IRMA 
interface) 


ability to easily and quickly remap 
the keyboard 


can hot key between emulation and 
DOS applications 


national language character set 
support 


diagnostics 

support for screen prints to PC 
printer or to the printer attached 
to the control unit 


ability to remap 3279 color 
attributes 


XViii 


Users can reconfigure the keyboard keys 
for greater flexibility, thereby 
tailoring keys for special applications 
as well as configuring the keys to 
correspond to international market 
needs. 


In 3279 emulation mode, users can 
configure colors for special 
‘application requirements. 


Built with the quality for which IDEA 


products are known, the IDEAcomm 3278 
comes with a one year limited warranty. 
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Section I: 


Introduction 


The IDEAcomm 3278 card allows the 
PC/XT/AT to be connected by coaxial 
cable to an IBM 3274 or 3276 control 
unit. The IDEAcomm 3278 software 
permits a PC to emulate an IBM 
3278/3279 Display Station. A typical 


system configuration is shown in Figure 
l-l e 
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Figure 1-1: Typical System 
Configuration 
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For details of the programs and data 
streams used by the IBM 3278, refer to 
the IBM publications: 


o GA18-2181 3278 
; 3276 Control Uni! 
Display Station, Description and 
Programmer's Guide. 
Oo GA23-9861 IBM 3278 Information 
sp! 3274 Control Unil 
Descripti : ide. 
For details of the keyboard and screen 


operations possible on the 3270, refer 
to the following IBM publication: 


Oo GA27-2742 Operator's Guide for IBM 
3270 Inf i Disp] eT : 


1-2 Introduction 


Or izat] 


This manual is the basic reference for 
the IDEAcomm 3278 Communications 
package. 


Overview presents a summary of the 
IDEAcomm 3278's 
capabilities. 

Section I provides information on 


the setup of the user 
manual, notation 
conventions, reference 
publications, and an 
inventory checklist. 


Section II covers hardware 
installation and 
diagnostics. 


Section III information on loading 
IDEAcomm 3278 and making 
it resident. 


Section IV describes keyboard 
equivalents. 


Section V covers configuring 
IDEAcomm 3278 software. 
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Appendix 


Appendix 


Appendix 


Appendix 


Appendix 


Appendix 


Appendix 


IDEAcomm 3278 software 
messages are listed. 


provides technical 
information and diagnostic 
information. 


describes File Transfer 
(XFER). 


subroutines in BASIC. 


describes alternate switch 
settings. 7 


is a glossary of terms. 


offers customer support 
information. 
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Notation Conventions 


The following conventions are used in 
this manual: 


[J Square brackets indicate 
optional fields. 

eee Ellipses indicate that a 
field may not be 
repeated. 


A vertical bar indicates 
a choice. Choose one of 
the items separated by 
the vertical bar. One of 
the items must be 
entered, unless the items 
are also surrounded by 
square brackets. 


<filespec> A field shown as 
filespec indicates a 
Standard file 
specification of the 
following form: disk 
name:filename.ext 


punctuation Punctuation other’ than 
brackets, ellipses, and 
braces should not be 
entered as shown. 
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delimiters 


Ctrl- 
character 


Commands must be 
separated from their 
operands by one or more 
blanks. Multiple 
operands, are separated 
from each other by a 
comma, a comma followed 
by one or more blanks, or 
by one or more blanks. 
Blanks and commas may 
not appear within 
operands. 


The character “b" 
indicates a blank or 
space character. 


Ctrl-character indicates 
a Character that is 
generated by pressing the 
Ctrl key and the 
indicated “character" 


together. 
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In the screen illustrations of this 
manual, the characters that you must 
enter, appear in bold type. They 

are shown in lowercase letters, but 
may generally be entered in upper- or 
lowercase letters. Commands entered at 
the system prompt must be followed by 
pressing the (Enter) key. The first 
reference to command names in the text 
also appear in bold type. The names 
of keys that are referenced in thas 
manual appear as they do on the your 
IBM PC/XT/AT keyboard. Unless noted, 
the case of the letters you enter for 
commands is not critical. 


Inventory Checklist 


You should have received the following 
components: 


o IDEAcomm 3278 card 
o Support guide 
oO IDEAcomm 3278 Software 


oOo Installation and Reference Guide 
(this book) 


Oo Warranty Card 
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Hardware Installation 


Getting Started 


When you open your IDEAcomm 3278 
package, the first thing you notice 
will be the amount of packing material 
we have placed around the IDEAcomm 3278 
Card. This ensures that you receive an 
undamaged card. 


Please save your box and inside 
packaging material. If you need to 
return the card for repair, this 
packaging will provide the safest 
shipping container. 


Careful! 


During the installation process, please 
be careful with the IDEAcomm 3278 

card. Dropping the card and similar 
accidents may result in improper 
Operation. 
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Serial Number 


Please turn your IDEAcomm 3278 card to 
the circuit side. You will find the 
serial number along the top edge. 
Record this number NOW on both your 
warranty card and on the following line 
in this manual. 


Serial Number 


Please write the version number on your 
software diskette(s) here: 
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Hardware 
Installation Overview 


The IDEAcomm 3278 card can be installed 
with the following steps: 


1. Opening the IBM PC. 


2. Checking IDEAcomm 3278 card 
switches. 


3. Inserting the IDEAcomm 3278 
card. 


4. Replacing the IBM PC Cover. 
5. Connecting the coaxial cable. 


6. Running hardware diagnostics. | 
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Read through the whole installation 
procedure before proceeding. | 
Tool Requirements 


1. A medium size flat blade 
screwdriver. 


2. Pliers or a 1/4 inch socket wrench 
may be needed to remove the back 
cover of some models of the IBM PC. 

3. IDEAcomm 3278 card. 


4. Coaxial cable. 
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0 the IBM 
Preliminary Steps 

Turn off the IBM power switch. 

Turn off power to any peripheral 

tn (printer, monitor, hard disk, 


If you have an AT, unlock it. 


Unplug the computer and all peripherals 
from the wall outlet. 


Carefully note where each cable is 
attached. Disconnect all cables from 
the back of the IBM. 


Figure 2-1: Disconnecting the Cables 
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(Cover Removal) 


Move your keyboard and all peripheral 
equipment away from the work area. 


Position the IBM to allow rear access. 


With an AT, you must remove the back 
panel first. Pull firmly to detach the 
plastic fasteners. 


The cover is attached by two or five 
screws. With a flat blade screwdriver, 
remove the cover mounting screws by 
turning the screwdriver counter- 
Clockwise, as shown below. 


Certain models may require the use of 
pliers or a 1/4 inch socket wrench. 


Figure 2-2: Removing the Mounting 
Screws (CCW) 
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Carefully slide the cover away from the 
rear of the unit. When the cover will 
go no further, tilt it up and remove it 
from the base. See the sketch below. 
The AT requires no tilting. 


Figure 2-3: Removing the Cover 
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Checkj itc 


Refer to Figure 2-4 for the location 
switch banks 1, 2, and 3. 


interrupt Request Level Bracket 


COas AUS 
PM 61011603 © 1986 Rov o $00 


Swich Bank 2 
Memory Map 


IDOE Associaies 
COAX-PLUS 
PIN 610-11603 Swach Bank 3 
© 1985 Rev x S/N PC VO Address 


Connector 


Figure 2-4: IDEAcomm 3278 Card 
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Checking Switch Bank 1 - Interrupt 
Request Line 


Switch Bank 1 on the IDEAcomm 3278 card 
selects the interrupt request line 
(IRQ). 


The switches on Switch Bank 1 were set 
to IRQ5 at the factory and should look 
like those shown in Figure 2-5A if they 
are sliding switches or Figure 2-5B if 
they are rocker switches. 


See Appendix E for information on 
alternate IRQ settings. 
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ON OFF OFF 


Figure 2-5A: Switch Bank 1 Factory 
Settings - IRQ5 - 
(Sliding Switches) 


ON OFF OFF 


Figure 2-5B: Switch Bank 1 Settings - 
IRQ5 - (Rocker Switches) 
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If the settings are different, change 
them to correspond to Figure 2-5A or B. 


NOTE 


To set sliding switches, simply 
slide the tab to the ON or OFF 
position. 


To set rocker switches, press down 
the ON side of the switch to set 
it to ON or press down the OFF 
side of the switch to set it to | 
OFF. Use care when setting rocker 
switches. 
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Checking Switch Bank 2 - Memory 
Address 


Switch Bank 2 on the IDEAcomm 3278 card 
sets the memory address. 


The switches on Switch Bank 2 were set 
to D688 and 64K at the factory and 
Should look like those shown in Figure 
2-6A if they are sliding switches or 
Figure 2-6B if they are rocker 
switches. 


See Appendix E for information on 
alternate settings. 


NOTE 


If you are using an IDEAdisk (with 
memory address D@08) with IDEAcomm 
3278, note that you must change the 
IDEAdisk settings in order to avoid an 
address conflict. Refer to epeeness E 
for information on changing the 
IDEAdisk settings. 
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OFF OFF ON OFF OFF OFF 


Figure 2-6A: Switch Bank 2 Settings 
DO@G8 and 64K 
(Sliding Switches) 


OFF OFF ON OFF OFF OFF 


O123 4 § 6 


-BEDEEE 


Figure 2-6B: Switch Bank 2 Settings 
DO@O8 and 64K 
(Rocker Switches) 
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Checking Switch Bank 3 = PC I/0 
Address 


Switch Bank 3 on the IDEAcomm 3278 card 
sets the PC I/O address. 


The switches on Switch Bank 3 were set 
to 220-227 Hex at the factory and 
should look like those shown in Figure 
2-7A if they are sliding switches or 
Figure 2-7B if they are rocker 
switches. | 


See Appendix E for information about 
alternate switch settings. 
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ON OFF OFF OFF OFF OFF 


ONi 2 3 4 5 6 


Woda 


OFF 


Figure 2-7A: Switch Bank 3 Settings 
(220-227 Hex) 
(Sliding Switches) 


ON OFF OFF OFF OFF OFF 


Figure 2-7B: Switch Bank 3 Settings 
(220-227 Hex) 
(Rocker Switches) 
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Inserti t DEAC 3278 | d 


Once the switch settings are verified, 
you can insert the IDEAcomm 3278 card 
into any. empty full size expansion slot 
on your IBM PC. 


Use a flat blade screwdriver to remove 
the screw that holds the system 
expansion slot cover in place (turn the 
screw counterclockwise (CCW). Refer to 
Figure 2-8. 


Save the screw for installation of the 
IDEAcomm 5251 card. 


Slot Cover 
Back of IBM 


Figure 2-8: Removing the Slot Cover 


2-16 Hardware Installation 


Support Track 


A Support Guide is enclosed in your 
IDEAcomm 3278 package. Be sure that 
the Support Guide slot fingers are 
pointing down. Press the Support Guide 
into the holes in the front panel of 
the IBM. Note that if you have an IBM 
AT, the guides are already built into 
the system. 


Note the direction 
of the slot fingers: 
they should be 
pointing down 


Figure 2-9: Pressing the Support 
Guide in Place 
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Card Insertion 


Hold the card by both corners. Slide 
it down through the Support Guide, and 
firmly press the card into the 
expansion slot. Be sure the card is 
held by the support guide. 


Retaining Bracket 
Back of IBM 
x 


Card 


Figure 2-18: Inserting the Card 
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Card Alignment 


Align the hole in the IDEAcomm 3278 
card retaining bracket with the hole in 
the rear panel of the computer. Insert 
the screw through the 2 holes and turn 
it clockwise (CW). 


Gon 


Retaining Bracket 


EN 


Hole Alignment 


Figure 2-ll: Aligning the Card 
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Re op! 


If you have any other options to 
install, do so now, before replacing 
the cover. 


Replace the IBM cover by positioning it 
as shown, and carefully sliding it 
toward the rear of the computer. The AT 
requires no tilting. 


Figure 2-12: Replacing the IBM Cover 
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Re cj Cc 


When the cover is on, align the screws 
with the threaded tabs on the back of 
the cover. Tighten the screws using a 
flat blade screwdriver. Turn the 
screws clockwise (CW). 


If you have an AT, replace the back 
panel by pressing it into the plastic 
fasteners. Relock the AT if this seems 
desirable. 


Figure 2-13: Tightening the Cover 
Screws 
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Recabling the IBM 


You are now ready to recable your 
system. Please refer to the IBM Guide 
to Operations, "Set-up," for recabling 
the keyboard, monitor, printer, and 
other peripherals. 


Figure 2-14: Recabling the System 
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Hardware Diagnostics 


After installing the IDEAcomm 3278 
card, test the basic functionality of 
the hardware by running the diagnostic 
program to make sure that it is 
Operating correctly. 


Copying the Software 


Before you use the diagnostic program 
Or any IDEA software, make a backup 
copy of the software. To do this, you 
need your DOS diskette, a blank 
formatted diskette and the IDEAcomm 
diskette. 


Use the DOS COPY command to make the 
backup copy. For instructions on 
formatting a blank diskette or for 
information on the COPY command, refer 
to your DOS manual. Use the backup 
copy and put the original away for 
safekeeping. 


Running the IDEAcomm 3278 Hardware 
Diagnostics 


To run the diagnostic program make sure 
that the coax cable has not yet been 
connected. The diagnostic program may 
not function properly if you have 
already connected the PC to the IBM 
mainframe computer. 
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Type the following command to start the 
diagnostic program: 


( A>TEST3278 <CR> 


The program performs a series of tests 
on your PC and the IDEAcomm 3278 card. 


As each test is completed, the name of 
the test and the word Passed is printed 
on the screen. After the last test has 
been successfully completed, the 
following message is displayed at the. 
bottom of the screen: 


TEST3278-881 All IDEA3278 functions 
complete 


Refer to Figure 2-15. 
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UOTRETTeISUL SreMpIeg 


St-Cc 


IDEA3278 Diagnostic Utility 
Version x.xx 
Copyright(c) 198x IDEAssociates, Inc. 


Host micro I/O control port test .... 
8X3865 instruction memory/addressing test 
8x385 I/O addressing test .... 
Host micro screen memory test 
8X385 screen memory test ... 
8x3@5 8K offset jam test ... 
IRMA simulation test ..... 
Auto response loopback test . 


Digital coax loopback test . 
Analog coax loopback test. 


eeeeee@¢ 
eeeeeeie 
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Cr ee ee ee ee ee | 
eoeeeee@¢ 
eeeee#@e eee ¢@ 
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TEST3278-8681 All IDEA3278 functions complete 


Pigure 2-15: Diagnostic Test 


Note that your system is returned to DOS once the test is completed. 


Passed 
Passed 
Passed 
Passed 
Passed 
Passed 
Passed 
Passed 


Passed 
Passed 


Screen 


If a test is not passed during 
diagnostic testing, the word Failed is 
displayed next to the failed test. 
Also, the diagnostic program stops, an 
error message is displayed and the 
system is returned to DOS. Refer to 
Appendix A for an explanation of a 
diagnostic message. 


Refer to Appendix B for information on 
performing diagnostic tests one at a 
time and for an explanation of what 
each test checks. 
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Connecting a Coaxja] Cable 


After successfully running the 
diagnostics, you are ready to connect a 
coaxial cable from your PC to the IBM 
mainframe computer. 


Make certain that the locking mechanism 
of the coaxial connector is fully 
engaged. 


Coax Connector et 


Figure 2-16: Connecting a Coaxial Cable 


Make sure the coaxial cable is already 
connected to the IBM controller. The 

coaxial cable must be connected to an 

active controller before the IDEAcomm 

3278 emulation will start. 
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Section III: 


Using IDEAcomm 3278 


This section provides all the 
information you should need to load and 
use the IDEAcomm 3278 Command and 
IDEAcomm 3278 Emulation Modes under 
normal conditions. Command Mode 
commands and switching between Modes 
are also described. 


Us} D 2 


To use the IDEAcomm 3278 program, type 
the command shown below. 


( A>IDEA3278 <CR> 


The following IDEAcomm 3278 initiation 
message is displayed when the program 
is loaded. The > character is the 
Command Mode prompt. 7 


IDEA3278, Vn.n, SERIAL xx-nnnnn 
COPYRIGHT (c): 
CoaxxsyS~-MICRO~INTEGRATION, IE 
Systems 198n 

COPYRIGHT (c): IDEAssociates Inc. 
1983-1984-1985 

: | 
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You must enter at least one command to 
begin communications. 


Operating Modes 


IDEAcomm 3278 has.two modes of 
operation: 


o Command Mode is used to issue a 
variety of commands such as SEND, GO, 
DIR, etc. 


o 3278 Emulation Mode is the emulated 
3278/9 screen. The Hot Key feature 
(explained in this section) makes it 
possible to make the IDEAcomm 3278 
‘program a part of DOS, so that you 
can switch between Emulation and DOS 

,with a single keystroke. 


IDEAcomm 3278 Commands 
A few simple commands in Command Mode 


enable you to do a variety of things 
with IDEAcomm 3278. 
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IDEAcomm 3278 commands have the 
following syntax: 


<operation>b<operand> [delimiter 
operand>]... 


wheres: 


<operation> Specifies the command to 
be executed. 

<operand> Specifies the operand(s) 
required by the command. 
Operands may not contain 
imbedded commas or blanks. 


delimiter Must be a comma, one Or 
more blanks, or a comma. 
followed by one or more 
blanks. 


A summary of the commands, 
abbreviations, and uses is given in 
Table 3-1. In this manual, the 
abbreviated form is used for all 
commands. 
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Table 3-1 shows the abbreviations, and 
description of the IDEAcomm 3278 
software commands. 


Table 3-1: IDEAcomm 3278 Commands 


Abbre- 

Command i tintiek. Denobinkine 

CAPTURE C Capture a 3278 screen 
format for off line 
use. 

DIR D Display a disk 
directory. 

EXIT. EXIT Return to the 
operating system 
(only if IDEAcomm 
3278 is not 
permanently 
resident). 

GO G Enter 3278 Mode from 
Command Mode. 

HELP H Display helpful 


information. 
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PRINT P Assign a file or 
printer as the: local 
copy printer. 


SEND S Send a screen to the 
host computer. 


TYPE T Display a file. 


GO Command: Entering 3278 Emulation 
Mode 


To enter 3278 Emulation Mode, type the 
following: 


| 2GO <CR> 


The GO command can be abbreviated as 


After this command is issued, the PC 
screen is cleared and the PC is placed 
in 3278 Emulation Mode. See Section IV 
for a description of the 3278 keyboard 
Operations that may be eenperece in 
Emulation Mode. 
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If you want to use the local print 
feature in 3278 Emulation Mode, you 
must first define your printer file or 
device in the Command Mode. See the 
PRINT command in this section. 


To return to Command Mode, press the 
key configured as the EXIT key. (The 
default EXIT key is CTRL E.) 


Making IDEAcomm 3278 Resident - Using 
the Hot Key 


You can make the IDEAcomm 3278 program 
resident in memory by using the hot 
key. This enables you to switch back 
and forth between IDEAcomm 3278 and 
some other PC activity without logging 
off of the host. For example, while 
you are running IDEAcomm 3278 and are 
connected to a remote, you may need to 
see a directory of your disk drive, 
edit a file with a text editor, or you 
may want to upload or download files 
using IDEAcomm's advanced file transfer 
utility (XFER). 
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To make IDEAcomm 3278 resident, run 
IDEAcomm 3278 and use the GO Command to 
go into 3278 Emulation Mode. Press 
both SHIFT keys together. When one or 
both keys are released, the screen 
clears and you will see the DOS 

prompt. IDEAcomm 3278 is now 

resident. You can toggle into or out 
of 3278 Emulation Mode by pressing the 
two SHIFT keys together. Using the two 
SHIFT keys in this way is called HOT 
KEYING and the SHIFT keys are referred 
to as HOT KEYS. 


You can toggle into IDEAcomm 3278 at 
any time, whether the system is idle or 
whether a program or command is 
executing. You can toggle out of 
IDEAcomm 3278 at any time while you are 
in 3278 Emulation Mode. You will go 
back to whatever command or program was 
executing when you toggled into 
IDEAcomm 3278, and will continue from 
where that command or program left 

off. If nothing was executing, you 
will go back to the DOS prompt. 


After you have made IDEAcomm 3278 
resident, the only way to exit from 
IDEAcomm 3278 is by pressing both SHIFT 
keys (hot keying) while in 3278 
Emulation Mode. 
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Note that once you make IDEAcomm 3278 
resident, it remains resident until you 
reboot the operating system. 


PRINT Command 


You may configure the local printer to 
be either a printer on your personal 
computer system or an IBM printer 
attached to your 3274 or 3276 control 
unit. Refer to Section V for 
configuration information. Use the 
configuration software described in 
Section V to enter the configuration 
you require. 


The PRINT command is a Command Mode 

command and is used to direct output to 

a physical printer or to a disk file. 

The PRINT command assigns a location, 
it does not write data to a printer. 


If you configure it as a printer on 
your personal computer system, then you 
may use the IDEAcomm 3278 PRINT command 
to define the local printer to be 
either a physical printer or a logical 
printer (a disk file). You must assign 
the printer to either a physical 
printer or filename before going into 
emulation. 
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Note that if you define a physical 
printer as the printer that is attached 
to the IBM 3274/76 mainframe control 
unit, the PRINT command has no effect. 
When you press the Local Print key 
(CTRL P) the information displayed on 
your screen is sent to the location 
specified in the configuration 
software. 


Optionally, you can configure the 
IDEAcomm software to use the printer 
that is attached to the IBM 3274/76 
mainframe control unit using the 
configuration utility described in 
Section V. With this configuration, 
the PRINT command has no effect. When 
you request the Print Screen feature, 
it goes to your IBM control unit 
printer. | 


The format of the PRINT command is: 
PRINT PRN 

(to print to a printer) Or 
PRINT <filespec> 

(to Serine to a file) 


The abbreviated PRINT command is P. 
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PRN defines your PC's list device as 
the printer. 


<filespec> is the complete name 
(including drive specification) of the 
file to which the print output is 
directed. If no drive is specified, 
then the default drive is assumed. 


To assign the logical 3278 Print Screen 

printer to a file named PRNFILE.TXT on 

Drive B, enter the command shown 

below. Each time the local print key 

ea the data is sent to the named 
e. 


| >PRINT Bs PRNFILE.TXT <CR> 


The printer definition remains in 
effect until you enter another PRINT 
command or exit IDEAcomm 3278. The 
print line length is always 890 
Characters. 


To assign the logical 3278 local 
printer to the list device, type: 


( ?P PRN <CR> 
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Printer destined data will be sent to 
the list device each time the local 
print key is used. 


Remember that if you configure IDEAcomm 
3278 to use the 3278 printer attached 
to the control unit, the PRINT command 
has no effect. 


HELP Commands: Getting Information 

You can use the HELP command to display 
information about IDEAcomm 3278 
commands. When you type HELP, a file 
named IDEA3278.HLP is displayed. 


To use the HELP Command, type: 


( 2HELP <CR> 


The HELP Command may be abbreviated as 


To exit the HELP file, press the D 
key. 
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This file is displayed one page 
(screen) at a time. If the file is 
longer than one page, the last line on 
the screen gives you the option of 
cancelling the display by pressing the 
D key or continuing to the next page 
by pressing any other key. 


The IDEA3278.HLP file supplied with 
IDEAcomm 3278 contains a description of 
the IDEAcomm 3278 commands and what 
they do. It also contains a list of 
IBM 3278 keyboard keys and provides 
IDEAcomm 3278 keyboard equivalents. 

You may edit the IDEA3278.HLP file to 
include any information you think 
necessary, such as telephone numbers of 
your host computer. 


If you wish to customize the HELP file, 
the following considerations apply. 


o The file must be named IDEA3278.HLP 
and reside on the same disk as the 
IDEAcomm 3278 program. 


o Lines longer than 8@ characters are 
wrapped on the next line. 


Oo All logical lines must end with 


Carriage return/line feed (ODH, 
OAH). 
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o Upper- and lowercase ASCII characters 
are supported. 


Oo Horizontal tabs (89H) are not 
expanded. 


o The file is displayed one full screen 
at a time, less one line to allow for 
the message at the bottom of the 
screen. You may want to format your 
file so that the breaks between 
screens occur at reasonable places. 


TYPE Command: Displaying the Contents 
of a File 


This command displays the contents of a 
file on the screen, one screenful at a 
time. Lines longer than 89 characters 
are wrapped onto the next line. 


Upper- and lowercase characters are 
supported and no translation is 
performed on the data. Horizontal tabs 
are not expanded. Screen attribute 
Characters (for example, ina file 
created by a CAPTURE command) are 
displayed as spaces. High and low 
intensity attributes are ignored by the 
TYPE command, but non-display fields 
are displayed as spaces. 
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If the file is longer than one page, 
the last line on the screen gives you 
the option of cancelling the display by 
pressing the D key or continuing to 

the next page by pressing any other 
key. 


The TYPE command has the syntax: 


( >T <filespec> 


<filespec> Specifies the name of the 
file to be displayed. 

EXAMPLES: 

The following command will display the 


contents of a file on the current drive 
named JOBXYZ.901. 


>T JOBXYZ.881 <CR> 


The next command will display the 
contents of a file on drive B named 
JOBWED.ASM. 


( ?T Bs JOBWED.ASM <CR> 
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DIRECTORY Command: Displaying a File 
Directory 


The DIRECTORY command is used to 
display the directory of the specified 
drive. 


The format of the DIRECTORY command is: 
DIR [disk drive:] 


The abbreviated DIRECTORY command is 
D. 


[Disk drive:] specifies the drive 
containing the disk directory to be 
displayed. If the [disk drive:] 
parameter is omitted, the current drive 
is assumed. 


To display the directory of the current 
disk, enter the following command: 


( 2D <CR> 


To display the directory of the 
disk on drive B, type: 


| >D Bs <CR> 
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SEND Command: Sending Prepared Screens 
to the Host 


IDEAcomm 3278 allows you to prepare 
screens of data offline from the host 
computer, then send these screens to 
the host without operator 

intervention. The screens can be 
prepared using an editor, a data entry . 
program, or by using a program that you 
write. No matter how the screens are 
prepared, IDEAcomm 3278 treats data in 
the screen file as a series of 
keystrokes that are used to put data 
onto the 3278 screen. You must format 
the screen files so that the data in 
the files goes into the proper location 
on the screen. 


Data in the files can be any 
displayable ASCII characters, plus the 
tab character. Other characters cannot 
be sent and will stop the send 
Operation if they are present in the 
file. Screens in the file are 
separated by the carriage return/line 
feed sequence so that each logical 
record in the file is one screen. 


(Note that you may also use the XFER 
file transfer utility described in 
Appendix C to move whole files of data 
to and from a host.) 
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You can use the CAPTURE command to 
Capture screen formats to allow you to 
Create the proper input formats easily. 


The SEND command has the formats: 


S <filespec>[,<filespec>...] 
[/P|/NP] 


wheres 


<filespec> Is the name of a file to 
be transmitted. Up to 
eight filenames may be 
specified, separated by 
commas. 


/P Specifies that the 
transmission is to be in 
Prompt Mode. 


/NP Specifies that the 
transmission is to be in 
No-Prompt Mode. 


The mode may be specified only once per 
command, and applies to all files in 
the command. 


If both /P and /NP are omitted, Prompt 
Mode is assumed. 
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When you enter a SEND command, IDEAcomm 
3278 goes into 3278 Mode. | 


With the No-Prompt option, each file 
named in the command is read and file 
data is used to fill unprotected fields 
in the display buffer. When a carriage 
return is encountered in the file data, 
the current display buffer is 
transmitted to the host computer. If 
the end of the display buffer is 
reached before a carriage return is 
encountered, the file record wraps 
around to the beginning of the buffer. 
After the remote responds by unlocking 
the keyboard, this process is repeated 
until end-of-file on the last file 
specified. Transmitted data is 
displayed to you as the screen is 
filled. 


With the Prompt option, each file named 
is read and file data is used to fill 
unprotected fields in the display 
buffer as in No-Prompt Mode. In Prompt 
Mode, however, your action is required 
to transmit the display data to the 
host. You may move the cursor on the 
display and modify data in the buffer 
through keyboard action, you may cause 
the screen to be sent to the host by 
using the RETURN or PF keys, and you 
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May cause the screen to be bypassed 
(not sent to the host) by using the 
CLEAR key. The CLEAR key AID is not 
sent to the host during SEND 
processing. After the keyboard is 
unlocked, the next record from the file 
is read and processed as above. 


Data from the file is placed in 
unprotected display locations in both 
modes. Tab (99H) characters in the 
file cause a programmatic tab to the 
next unprotected field. 


All protected fields are logically 
treated as autoskip, so that it is not 
possible to enter data into any field 
except an unprotected field. 


Data existing in unprotected display 
fields will be overwritten with file 
data. 


Modified Data Tags (MDTs) for fields 
that have data inserted are set. MDTs 
are not set for fields that are tabbed 
over. 


After all files have been sent, 
IDEAcomm remains in 3278 Emulation 
Mode. Reentering Command Mode during 
file transmission aborts the 
transmission. 
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CAPTURE Command: Capturing a Screen 
Format 


IDEAcomm 3278 software provides a 
convenient way to capture screen 
formats. These formats can then be 
used as models to write programs that 
Create data to be sent to the mainframe 
using the SEND command. 


The IDEAcomm 3278 CAPTURE command has 
the format: 


C <filespec> 


<filespec> Specifies the name of 
the file that is to 
contain the screen 
format. 


When you CAPTURE a screen format, 
IDEAcomm 3278 creates a file that 
contains the screen image. The file is 
a single record of 1,928 characters. 
The first character in the file is the 
first character on the screen and the 
last character in the file is the last 
character on the screen. If the 
absolute value of a character is 
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greater than 191 (the 2 high-order bits 
are one), the character is an IBM 
attribute character.* If the value of 
the character is 191 or less (the 2 
high-order bits are zero), it is an 
ASCII data character. It may also be a 
null character (90H). The data is 
Captured exactly as it appears on the 
screen, with all data, both protected 
field data and unprotected field data. 
Data in nondisplay fields is not 
captured, but is replaced by null 
characters (99H) in the CAPTURE file. 


*Refer to Table 3-2 for information on 
IDEAcomm 3278 Attribute Bytes. Also, 
see the IBM publications listed in 
Section I for more information about 
the 3278 screen. 
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(IDEAcomm 3278 Attribute Bytes) 


The attribute bytes written into the 
CAPTURE file by IDEAcomm 3278 are the 
same as the IBM attribute bytes, except 
that the second-highest order (X'40') 
bit is always one. The IBM attribute 
bytes sometimes have this bit set and 
sometimes they do not, depending on the 
other bits in the byte. The following 
table shows the definition of the 
IDEAcomm 3278 bits. 


Table 3-2: IDEAcomm 3278 Attribute 
Bytes 


DESCRIPTION 


Always 1! 
Always 1 


0 = Unprotected 

1 = Protected 

0 = Alphanumeric 

1 = Numeric 

00 = Normal intensity, not pen detectable 
01 = Normal intensity, pen detectable 

10 = High intensity, pen detectable 

11 = Nondisplay 

Always 0 


0 = Field has not been modified 
1 = Field has been modified 
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Note that a screen that is captured 
Cannot be used with the SEND command, 
because some of the characters are not 
ASCII characters... 


EXAMPLES: 
The following command writes the 


contents of the screen to a file on 
drive B called SCREEN@1.CAP. 


( >C BsSCREEN@1.CAP <CR> 


The next command writes the contents of 
the screen to a file on the current 
drive called FORM.XYZ. 


| >C FORM.XYZ <CR> 
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EXIT Command: Terminating IDEAcomm 
3278 


To exit the IDEAcomm 3278 program and 
return to the operating system, enter 


the following command while in Command 
Mode: 


( EXIT <CR> 


You must spell out the word EXIT. 


NOTE 


If you have made IDEAcomm 3278 
resident, you can no longer exit 
this way. See the next page for 
information on Exiting. 
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Exiting 3278 Mode, Entering Command 
Mode 


To exit 3278 Emulation Mode and receive 
the IDEAcomm Command prompt, press the 
key configured as the EXIT key. 
IDEAcomm 3278 leaves 3278 Emulation 
Mode, clears the terminal screen, and 
enters Command Mode. Data in the 3278 
buffer is preserved and will be 
redisplayed if a GO command is issued 
to reenter the 3278 Emulation Mode. 


You would enter Command Mode to, for 
example, change the logical 3278 
printer device or to exit IDEAcomm 3278 
and return to the operating system. 


EXAMPLE: 


To enter Command Mode, press the key 
configured as the EXIT key. The 
default EXIT key is CTRL E. 
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The terminal screen is cleared and the 
IDEAcomm 3278 startup message and 
command prompt is displayed: 


IDEA3278, Vn.n, SERIAL xx-nnnnn 
COPYRIGHT (c) 198n, 
Micro~Integration, Inc. 
Distributed by distributor name 


> 


Program Messages 


The IDEAcomm 3278 program issues 
messages that inform you of current 
execution status. All messages are of 


the form: 


XFER-nnn message text 


where: 


Ann 


message 
text 


Is a unique message 
identifier that provides 
easy reference to the 
message explanation. 
IDEAcomm 3278 program 
messages are documented in 
detail in Appendix A. 


Is a short message briefly 
describing the action 
required, condition found, 
Or program status. 
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Section IVs: 


Operations 


IDEAcomm 3278 allows your PC to perform 
all the keyboard and screen functions 
of an IBM 3278/79 display terminal. It 
also allows you to do things that you 
cannot do on a real 3278, such as 
transfer files to or from the PC and 
from the PC to the host or capture 
screen data into PC files. IDEAcomm 
3278 lets you use a LOCAL PRINT key to 
copy the screen to a file or to the 
printer. 


Keyboard Equivalents 


The IDEAcomm 3278 program automatically ; 
defines your PC keys as 3278 keys when 
you are in Emulation Mode. Refer to 
Figure 4-1 for a list of the 3278 
keyboard characters and their PC 
equivalents. 
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You can redefine the PC's 3278 keyboard 
characters to define 3270 keys not 
present on the real personal computer 
keyboard. You can change key 
definitions by using the configuration 
program described in Section V. For 
example, the 3278 keys RESET, SYS 
REQUEST, PAl, and PA2 are commonly used 
keys that usually are not physically 
present on a personal computer 
keyboard. In this case you might type 
CTRL R on your keyboard for the 32786 
RESET key. 


Other than the key changes noted above, 
IDEAcomm 3278 keyboard operations 
duplicate those of an IBM 3278. See 
the IBM publications listed in Section 
I for a description of the 3270 | 
keyboard and screen operations. 
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(ALT/F2) 
(ALT/F3) 
(ALT/F4) 
(ALT/FS) 
(ALT/F6) 
(ALT/F7) 
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18-PF18 
19-PF19 
20-PF29 
21-PF21 
22-PF22 
23-PP23 
24-PF24 
25-PAl 
26-PA2 
27-TEST 
28-ENTER 
29-CLEAR 
30-RESET 
31-EXIT 
32-DUP 
33-HOME 
34-TAB 


(ALT/FS ) 
(ALT/P9 ) 


(ALT/F18) - 


(CTRL/F1) 
(CTRL/F2) 
(CTRL/F3) 
(CTRL/F4) 
(CTRL/FS) 
(CTRL/F6) 
(CTRL/T ) 
(RETURN ) 
(CTRL/Z ) 
(CTRL/R ) 
(CTRL/E ) 
(CTRL/O ) 
(BOME ) 
(TAB ) 


35-BACK TAB 
36-NEW LINE 
37-INSERT 
38-DELETE 
39~ERASE EOP 
40-ERASE INPUT 
41-FPIELD MARK 
42-LOCAL PRINT 
43-CURSR RIGHT 
44-CURSR LEFT 
45-CURSR UP 
46-CURSR DOWN 
47-CORSR SEL 
48-SYS REQ 
49-ATTN 

S6=-DEV CNCL 
51-IDENT 
S2-BACK SPACE 


(SHIFT/TAB) 
(CTRL/N 


(INS 
(DEL 
(CTRL/L 
(CTRL/K 
(CTRL/F 
(CTRL/P 
(RTARROW 
(LFARROW 
(UPARROW 
(DNARROW 
(CTRL/W 
(CTRL/S 
(CTRL/V 
(CTRL/Q 
(CTRL/Y 
(BKSPACE 
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Loc int 


The Local Print key (Ctrl P) lets you 
copy the data displayed on the screen 
to a file or printer. Any serial or 
parallel printer configured for your PC 
Can accept screens. To use the Local 
Print key, you must first direct the 
output to a specified file or printer 
entered via the PRINT command while in 
the Command Mode. Next, from the 3278 
Emulation Mode enter Ctrl P. This . 
causes the information currently 
displayed on the screen to be written 
to the file or device specified in the 
PRINT command. If a disk file was | 
specified, each time Ctrl P is entered 
the new information is appended to data 
already in the file. If you did not. 
issue a PRINT command, entering Ctrl P 
will do nothing. The LOCAL PRINT key 
is defined in Figure 4-l. 


Status Line Symbo] Equivalents 


The 3278 reserves a line at the bottom 
of the screen called the Status Line. 
The IBM 3278 uses special symbols on 
this line to show the status of the 
3278 operation. The IDEAcomm 3278 
software also emulates this feature of 
the IBM 3278, but uses a slightly 
different set of status symbols. The 
differences are shown in Figure 4-2. 
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Figure 4-2: PC'S 3278 Status Symbol 
Equivalents 
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Section V: 


Configuring IDEAcomm 3278 Software 


The Configuration Utility 


The IDEAcomm 3278 program allows you to 
configure various options of the 
software such as, remap the keyboard, 
set nationality, and set up field 
attributes for 3279 color monitor 
emulation etc. 


When you receive the IDEAcomm 3278 
program, it is ready to run. The 
options have been set to default values 
and all 3278 keys have been defined as 
described in the IDEAcomm 3278 HELP 
file. You can reconfigure IDEAcomm 
3278 by running the Configuration 
Program. This program provides you 
with a series of menus that step you 
through the configuration process. 


The first menu, called the Main Menu, 
allows you to select the options you 
want to configure. When you select an 
option on the Main Menu, subsidiary 
menus are then displayed to do the 
configuration you select. The 
following text describes each menu and 
the options you can enter. 
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Using the Configuration Program 


The configuration program, CFIG.COM is 
on your copy of the IDEAcomm 3278 
software diskette. To run the program, 
place the IDEAcomm diskette in Drive A 
and type the following command: 


A>CFIG <CR> 


The Main Configuration Menu is 
displayed. 


The Main Menu 


The Main Menu is displayed when you 
start the configuration utility and 
each time you complete a configuration 
item selected from the Main Menu. 
Other menus are displayed when you 
select one of the lettered options and 
press RETURN. | 
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* IDEA3278 Configuration Program Vnn.nn.nn * 
Copyright(c) 198n, IDEAssociates, Inc. 
* Copyright (C) 198n, Micro-Integration, Inc. * 
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Select an Option: 


Configure Power-Off 
Configure Local Printer 
Configure Nationality 
Configure 3278 Keyboard 
Configure Display 
Configure Compatibility 


 i-eel oo 


Exit with no changes 
- Exit and change configuration 


Ne 
| 


Pigure S5-l: Configuration Main Menu 
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(Overview of Options) 


A 


The Power-Off option can either 
simulate a 3278 power-off 
condition when you exit the 
IDEAcomm 3278 program, Or it can 
keep the 3278 in a power-on 
condition when the IDEAcomm 3278 
program is not running. 


The Local Printer key can be 
configured to either send print 
requests to the printer or file 
defined using the PRINT command, 
to send them to the 3278 printer 
attached to the IBM control 
unit. 


The 3279 Keyboard option allows 
you to change the current 
definition of a specific key. 
IDEA's remapping process 1s 
quick and easy to use. 


With the Configure Nationality 
is for users with non-U.S.A. 
keyboards. This option allows 
you to change the character set 
you wish the emulated 3278 
keyboard to use. 


On the Configure Display menu, 
you can specify whether you will 
be running IDEAcomm 3278 on a PC 
with a monochrome or a color 
display and can set colors for a 
color display. 
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F - The Configure Compatibility Menu 
allows you to choose Native 
mode, IRMA mode, or Both. 


1 - If you select Option 1 and press 
RETURN, the Configuration 
Program ends without saving any 
changes you have made. The 
configuration file will remain 
the same as it was before you 
started the Configuration 
Program. 


2 - .If you select Option 2 and press 
RETURN, the Configuration 
Program ends and makes your 
configuration changes permanent. 


Option A - Configure Power-Off 
When you select Option A on the Main 


Menu and press RETURN, the Power-Off 
Menu is displayed. 
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Power~-Off 


Do you wish to simulate 3278 power-off 
when the IDEA3278 program is exited? 


Enter Y or N --.N<-— 


Press <ESC> to return to Main Menu with no change. 
Press <RETURN> to return to Main Menu and accept change. 


Figure 5-2: Power-Off Menu 
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The current value for the option is 

shown. You can press RETURN to accept 
the value displayed, change the value, 
Or press ESC to cancel any changes you 
have made and return to the Main Menu. 


If you enter Y, the IDEAcomm 3278 
program simulates a 3278 power off when 
you exit the IDEAcomm 3278 program. 
This erases the buffer that holds the 
3278 screen data and the screen is 
erased. This feature has no effect if 
you use the resident feature. 


If you enter N, the 3278 screen is 
saved while the IDEAcomm 3278 program 
is not running. When you run IDEAcomm 
3278 again, the data that was on the 
screen when you exited will be 
redisplayed. In this case, the 3278 
data is erased only when you turn off 
your PC, 


After you make your selection and press 
RETURN, the Main Menu screen appears. 
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Option B - Configure Local Printer 
When you select Option B on the Main 


Menu and press RETURN, the Local 
Printer Menu is displayed. 
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Locai Frincer 
Select an option: 


A - Use PC printer or file for local prints 
B - Use 32798 printer for local prints 


“> A<-— 


Press <ESC> to return to Main Menu with no change. 
Press <RETURN> to return to Main Menu and accept change. 


Pigure 5-3: Local Printer Menu 


The current value for this option is 

shown. You can press RETURN to accept 
the value displayed, change the value, 
Or press ESC to cancel any changes you 
have made and return to the Main Menu. 


If you select A, when you make a print 
request by pressing the key defined as 
the Local Print key, the request is 
sent to the printer or file you defined 
using the PRINT command. 


If you select B, any print request made 
by pressing the Local Print key is sent 
to the IBM control unit for processing 
by a 32798 printer attached to that 
unit. 


After you make your selection and press 
RETURN, the Main Menu is displayed. 
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Option C - Configure Nationality 


The Configure Nationality menu allows 
your IDEAcomm 3278 to support one of 

the international language character 

sets displayed on the menu. When you 
select Option C on the Main Menu, the 
Nationality Menu is displayed. 
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Nationality 
Select an option: 


OS English 

UK English 
Austrian/German 
French AZERTY 
Italian 
Norwegian 
Spanish 

Swedish 

Prench Canadian 
Portuguese 


Geman MmoO OW 


-->A< =~ 
Press <ESC> to return to Main Menu with no change. 


Press <RETURN> to go on to next screen and accept chang 


Figure 5-4: Nationality Menu 
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This menu allows you to select the 
A pd teehee character set for IDEAcomm 
3278 for various languages. 


The languages displayed on your menu 
may differ from those shown in Figure 
5-4. Also, you must have the 
corresponding language file (a filename 
with a .LNG extension) on your disk for 
the language you select. After you 
have configured the new language, you 
do not need to keep the other 

language files on the disk you use to 
execute the Configuration Program or 
IDEAcomm 3278. 


Enter the letter corresponding to the 
desired language, then press RETURN to 
return to the Main Menu. Pressing ESC 
returns you to the Main Menu without 
changing the previous option. 
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Option D - Configure 3278 Keyboard 
When you select Option D on the Main 


Menu and press RETURN, the 3270 
Keyboard Menu is displayed. 
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ST-S 


G1-PFl 
92-PF2 
83-PF3 
04-PF4 
85-PFS 
86-PF6 
87-PF7 
88-PFS8 
89-PP9 
16-PF18 
l1-PF11 
12-PF12 
13-PF13 
14-PF14 
15-PF15 
16-PF16 
17-PF17 


(Fl ) 
(F2 ) 
(F3 ) 
(F4 ) 
(FS ) 
(F6 ) 
(F7 ) 
(F8 ) 
(F9 ) 
(F180 ) 
(ALT/F1) 
(ALT/F2) 
(ALT/F3) 
(ALT/P4) 
(ALT/FS) 
(ALT/F6) 
(ALT/F7) 


18-PF18 
19-PF19 
28-PF28 
21-PF21 
22-PP22 
23-PF23 
24-PF24 
25-PAl 

26-PA2 

27-TEST 


28-ENTER 
29-CLEAR 
3@-RESET 


31-EXIT 
32-DUP 
33-HOME 
34-TAB 


(ALT/F8 ) 
(ALT/F9 ) 
(ALT/F18) 
(CTRL/F1) 
(CTRL/F2) 
(CTRL/F3) 
(CTRL/F4) 
(CTRL/F5) 
(CTRL/F6) 
(CTRL/T ) 
(RETURN ) 
(CTRL/Z ) 
(CTRL/R ) 
(CTRL/E ) 
(CTRL/U ) 
(HOME ) 
(TAB ) 


35-BACK TAB 
36-NEW LINE 
37~-INSERT 
38-DELETE 
39-ERASE EOP 
4Q8-ERASE INPUT 
41-FIELD MARK 
42-LOCAL PRINT 
43-CURSR RIGHT 
44-CURSR LEFT 
45-CURSR UP 
46-CURSR DOWN 
47-CURSR SEL 
48-SYS REQ 
49-ATTN 

58-DEV CNCL 
51-IDENT 
52-BACK SPACE 


Select the 3278 key you want to define --> <--, 


Leave selection blank to return to Main Menu and accept changes. 


Press <ESC> to return to Main Menu with no changes. 
Press <RETURN> to accept selection and go on to next screen. 
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3278 Keyboard Menu 


(SHIFT/TAB) 


(CTRL/N 
(INS 
(DEL 
(CTRL/L 
(CTRL/K 
(CTRL/F 
(CTRL/P 
(RTARROW 


(LFARROW 
(UPARROW 
(DNARROW 


(CTRL/W 
(CTRL/S 
(CTRL/V 
(CTRL/Q 
(CTRL/Y 
(BKSPACE 


) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 
) 


The menu shows you a list of 3279 keys 
that may not be present on your 
keyboard. It. allows you to change the 
way you Simulate the key. The current 
definition of each key is shown inside 
the parentheses. 


Note that the PA-3 key is not supported 
by IDEAcomm 3278. 


NOTES ON KEYBOARD CONFIGURATION 


There are several things you 
should keep in mind as you define 
your keyboard. 


1. The Configuration Program does 
not allow you to use one of 
your keyboard keys for more 
than one 3278 key. You 
cannot, for instance, use Ctrl 
Z for both CLEAR and ENTER. 
Likewise, you Cannot use two 
different keys to represent 
the same 3278 key. For 
example, you cannot use both 
Ctrl Y and Ctrl Z for PFl. 
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2. 


3. 


The Configuration Program does 
not allow you to leave any 
3278 keys undefined. If any 
keys are undefined, the 
message **UNDEFINED KEY(S) ** 
appears on the 3278 Keyboard 
Menu and you are not able to 
return to the Main Menu ane 
you define them. 


When you change a key 
definition in the 
Configuration Program, the 
IDEAcomm 3278 HELP file is 
not automatically updated. 
Use a text editor to change 
the IDEAcomm 3278 keyboard 
equivalents in the HELP file. 


You cannot use Ctrl/Alt/Delete 
for any key because this key 
combination reboots the 
operating system. 
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Use the form in Table 5-1 to keep a 
record of any changes you make to the 
keyboard configuration. 
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Table S-l: 


3278 Key Config. 


pri 
Pr2 
Pr3 
Ppré 
Pers 
Pre 
Pr? 
Pre 
Pre 
Pris 
Prll 
PF12 
PF13 
PFL4 
Pris 
PF1é 
PFi7 


User Defined 3278 Keyboard Equivalents Form 


3278 Key Config. 3278 Key 
Pris ce BACK TAB 
Pris aaa KEW LINZ 
pr2s eta INSERT 
rr2i a DELETE 
Ppr22 eee ee ERASE for 
PP23 eA ERASE INPUT 
Pr26 ba PIELD MARK 
PAL fear LOCAL PRINT 
PA2 ae CORSR RIGHT 
TEST aie, CURSR LEFT 
ENTER —s CORSR UP 
CLEAR arena CURSR DOWN 
RESET eee CORSR SEL 
Exit Seeceeeee SYS REQ 
bor See eee ATTN 
BORE ae DEV CNCL 
TAB Sciacca IDenrt 

BACK SPACE 
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Config. 


METER 


3-19 


To change the definition of a key on 
the emulated 3278 keyboard, type in the 
number of the key you want to change, 
then press RETURN. If, for instance, 
you want to change the CLEAR key, you 
would type 29 <CR>. When you type in 

a key number and press RETURN, the menu 
shown in Figure 5-6 is displayed. 
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3276 Key Definition 
Press the xxxxxxxxxxx key sequence. 
-—> 


RXXXXXXXXRX previously defined as yyyyyyyy 


Pigure 5-6: 3276 Key Definition Screen 
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On the actual menu, xxxxxxxxxxx will 
show the 3278 key you are defining and 
YYYYYYYY will show the current 
definition. | 


To change the definition, press the PC 
key that is to be interpreted as the 
3278 key. The screen will redisplay 
the 327@ Keyboard Menu which now shows 
the new key definition. You can 
continue to define keys, or you can 
return to the Main Menu by pressing 
RETURN without typing a number. 


EXAMPLE 


To change the PFl key definition to 
Ctrl Z: 


1. Type 1 (the PF1 key number) and 
press RETURN on the 3278 Keyboard 
Menu. 


2. Type Ctrl Z on the 3278 Key 
Definition Screen. 
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Option E - Configure Display 


When you select Option E on the Main 


Menu and press RETURN, the Display Menu 
is shown. 
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Dispiay Type 
Select an option: 


A - Color display 
B - Monochrome Display 


“AC -— 


Press <ESC> to return to Main Menu with no change. 
Press <RETURN> to go on to next screen and accept change. 


Figure 5-7: Display Menu 
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You use this menu to specify whether 
you are running IDEAcomm 3278 on a PC 
with a monochrome or a color display 
and to select the colors IDEAcomm 3278 
will use to display fields with various 
attributes. 


If you choose A and press RETURN, the 


Display Field Colors screen appears. 
Refer to Figure 5-8. 
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Field Colors 


Select a color option for each field type: 


A-Blue 


Unprotected 
Unprotected 
Unprotected 
Unprotected 
Unprotected 
Unprotected 
Protected 
Protected 
Protected 
Auto Skip 
Auto Skip 
Auto Skip 
Status Line 


B-Red C-Magenta 


Alphanumeric 
Alphanumeric 
Alphanumeric 
Numeric 
Numeric 
Numeric 
Alphanumeric 
Alphanumeric 
Alphanumeric 


Status Line Messages 


D-Green E-Cyan 


Nondetectable 
Detectable 
Detectable 
Nondetectable 
Detectable 
Detectable 
Nondetectable 
Detectable 
Detectable 
Nondetectable 
Detectable 
Detectable 


Press <TAB> to select next field. 
Press <BSC> to return to Main Menu with no changes. 


Press <RETURN> to return to Main Menu and accept changes. 


Pigure 5-8: 


Display Field Colors Screen 


F-Yellow G-White 


Normal Intensity 
Normal Intensity 
High Intensity 
Normal Intensity 
Normal Intensity 
High Intensity 
Normal Intensity 
Normal Intensity 
High Intensit 
Normal Intensity 
Normal Intensity 
Bigh Intensity 


H-Black 


-->D<—— 
-—>D<-= 
-->B<-= 
-->D<-- 
-->D<-- 
-->B<-- 
-->A<-- 
-->A<-— 
-—>G<-= 
~=>A<-= 
-->A<-- 
-->G<-- 
-->A<== 
==>F<-- 


I-0ff 


Green 
Green 
Red 
Green 
Green 
Red 
Blue 
Blue 
White 
Blue 
Blue 
White 
Blue 
Yellow 


The Display Field Colors screen lists 
all possible combinations of attributes 
that a field on the screen may have, 
and shows the color currently selected 
for fields with each combination. (For 
a complete explanation of fields and 
attributes, see the IBM publications 
listed in Section I.) A list of 
possible colors and the letter you 
should enter to select each is also 
shown. When the menu appears, the 
cursor is on the first line of the list 
of attribute combinations. To move the 
cursor to the next line, press the TAB 
key. To change the display color for 
fields with a given attribute 
combination, move the cursor to the 
appropriate line and enter the letter 
corresponding to the desired color. 

For example, to change unprotected 
numeric detectable normal intensity 
fields to blue, tab to the 5th line and 
type A. 


Fields configured as Off (choice * are 
not displayed. 


After entering all your changes, press 
RETURN to return to the Main Menu and 
to write your changes. Press ESC to 
return to the Main Menu without 
changing the original settings. 
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If you choose B on the Display Menu 
and press RETURN, the'Main Menu will be 
displayed. IDEAcomm 3278 will display 
fields on the 3278 screen using high 
and low intensity as on a standard 
monochrome IBM 3278 display station. 
Any colors previously configured on the 
Display Field Colors screen will be 
ignored. Remember that to exit without 
He changes, you must use the ESC 
ey. 


NOTE 


If your personal computer has a 
color display and you specify 
monochrome, IDEAcomm 3278 will 
display all fields as either green 
or white. 


If your personal computer has a 
monochrome display, you must 
specify monochrome or your 3278 
display may not be stable. 
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Option F - Configure Compatibility 
When you select Option F on the Main 


Menu and press RETURN, the 
Compatibility Menu is displayed. 
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Compatibility 
Select an option: 


A - NATIVE 
B - IRMA 
C - Both. 


-->C<-- 


Press <ESC> to return to Main Menu with no change. 
Press <RETURN> to return to Main Menu and accept change. 


Figure 5-9: Compatibility Menu 
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NATIVE 

Native mode provides extremely fast 
transmission speeds. If you choose 
this option, you can run programs. 
written for IDEA Native mode, but you 
Cannot run IRMA compatible software. 


IRMA 

Use the IRMA mode when you are linking 
to a mainframe application that 
requires the IRMA interface. If you 
choose this mode, you cannot run 
programs written for IDEA Native mode. 


BOTH 

If you plan to use both IDEA Native 
programs and IRMA compatible programs, 
choose the BOTH option. Note, however, 
that the BOTH mode causes some 
degradation in performance. Therefore, 
if you do not plan to use IRMA 
compatible programs, choose NATIVE. If 
you do plan to use IRMA compatible 
programs, choose IRMA mode. 
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Making Configuration Changes Permanent 


After you have gone through the 
configuration process, at the Main Menu 
you can keep pressing RETURN to cycle 
through all the menus. This gives you 
a chance to check the configuration 
changes you made. When you are 
Satisfied that you have set the 
configuration correctly, select Option 
2 on the Main Menu, then press RETURN 
to make your configuration permanent. 


Preserving the Original Configuration 


If you decide to keep the original 
values, enter Option 1] at the Main 
Menu, then press RETURN. This stops 
the Configuration Program without 
making any changes. 


After the configuration is complete, 


you are ready to use the Emulation 
program. 
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Configuration Messages 


The Configuration Program has a set of 
status messages to assist you during 
the configuration process. When 
applicable, these messages appear near 
the bottom of the configuration menus. 
A list of the messages and a 
description of each follows. 


Error opening configuration file 
Error closing configuration file 
Error writing configuration file 


The operating system detected an 
I/O error while the configuration 
program was attempting to access 
the configuration file 
IDEA3278.UCM. If the error 
occurred while opening the file, 
the file may not be present on the 
current disk. 


Invalid character 


The character you entered is not 
within the range of characters 
allowable for the current option. 
For example, you may have entered a 
letter where a number is required. 
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Invalid option 


What you entered is not in the list 
of allowable options given in the 
menu. 


Invalid key number 


In the 3278 Keyboard Menu, you 
selected a key number other than 
those listed. 


Key sequence not definable 


Certain keys on the personal 
computer keyboard may not be used 
to define 3278 keys. 


**UNDEFINED KEY(S) ** 


When this message appears in the 
3278 Keyboard menu, it means that 
one or more 3278 keys currently are 
not defined, and you must define a 
personal computer key to represent 
them before returning to the Main 
Menu. 
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Appendix A: 


IDEAcomm 3278 Software Messages 


Program Messages 


The IDEAcomm 3278 program issues 
messages about the status or the 
Operation at hand. All messages are in 
the following form: 


IDEAcomm 3278-n message text 


n”" is a unique message identifier. 


IDEAcomm 3278-981 | EXITED IDEAcomm 
3278 

In response to the EXIT command, 
IDEAcomm 3278 has returned to the 
Operating system. 


IDEAcomm 3278-902 INVALID COMMAND 
The command just entered was not a 
valid IDEAcomm 3278 command. Re-enter 
the correct command. 


IDEAcomm 3278-993 UNABLE TO OPEN 
FILE - <filespec> | 
IDEAcomm 3278 was unable to open the 
file specified by <filespec>.. 


Software Messages A-l 


On input, you may have specified a file 
that does not exist. Check the 
spelling or check the disk directory 
with the DIR command. 


On output, the disk may be read-only, 
the disk may have a bad sector, or the 
disk or directory may be full. 


IDEAcomm 3278-004 UNABLE TO CLOSE 
FILE - <filespec> 

IDEAcomm 3278 was unable to close 
the file specified by <filespec>. 


IDEAcomm 3278-005 INVALID FILENAME 
SPECIFIED 

A filename in the previous command was 
not specified properly. The syntax of 
the name is not correct. 


Reenter the command, specifying the 
correct filename. 


IDEAcomm 3278-096 I/O ERROR ON FILE 
~ <filespec> 

A non-recoverable file I/O error has 
occurred. The current operation in 
progress has been aborted. 
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The file data may have been compressed, 
or the disk may be full or have a bad 
sector. 


Recreate the file or use a different 
disk and retry the operation. 


IDEAcomm 3278-907 FILE ALREADY 
EXISTS - DELETE (Y OR N? - <filespec> 
The file specified by <filespec> 
already exists. 


Reply "Y¥" to delete the existing file 
and create a new file with the same 
name. 


Reply "N" to preserve the existing 
file, then reissue the previous command 
using a different filename. 


IDEAcomm 3278-868 DIRECTORY 
LISTING . 
This message precedes the dis 
directory listing produced by the 
IDEAcomm 3278 DIRECTORY command. 


Software Messages A-3 


IDEAcomm 3278-989 INVALID DEVICE 
SPECIFIED 

The disk identifier specified for a 
file in the previous command was not in 
the range A to P. 


Reissue the command usSing the proper 
disk device identifier. 


IDEAcomm 3278-019 INVALID OPTION 
SPECIFIED 

A SEND command option other than /P or 
/NP was entered. 


Reenter the command with a valid 
option. 


IDEAcomm 3278-9811 nn FILES LISTED 
The DIRECTORY command has listed a 
directory of nn files. 


IDEAcomm 3278-812 INVALID CHARACTER 
IN SEND FILE 

While processing a SEND command, 
IDEAcomm 3278 has found a character 
other than a valid ASCII graphics. 
character in one of the files. being 
sent. The SEND operation has been — 
ended. 
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Remove the invalid character or 
recreate the file, and SEND the file 
again. You must also SEND any files 
specified in the SEND command after the 
bad file. All files preceding the bad 
file have been sent successfully. 


IDEAcomm 3278-813 MORE THAN EIGHT 
FILES SPECIFIED | 

More than eight filenames were _ 
specified in one SEND command. Only 
eight are allowed. 


Reissue the command, specifying eight 
or fewer filenames. 


IDEAcomm 3278-014 FILE ALREADY OPEN. 
AS A PRINT FILE - <filespec> 

A filename specified in a TYPE or 
SEND command has already been specified 
in a PRINT command. | 


Change the printer assignment with 
another PRINT command then reissue the 
command that produced the error. 


IDEAcomm 3278-815 UNABLE TO LOAD 
MICROCODE 

IDEAcomm 3278 was unable to load the 
microcode program and start emulation. 
Make sure that the cable you have 
connected to the 3278 card is attached 
to an active IBM controller. 
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Ensure that the IDEAcomm 3278 board is 
installed properly. 


IDEAcomm 3278-016 NO UNPROTECTED 
FIELDS 
While processing a SEND command, 


IDEAcomm 3278 has attempted to put data. 


onto the screen when the screen has no 
unprotected fields. The current SEND 
operation is ended. 


Ensure that the SEND file matches the 
screen formats used by the host and 
SEND the file again. You must also 
SEND any files specified in the SEND 
command after the bad file. All files 
preceding the bad file have been sent 
successfully. 


IDEAcomm 3278-817 NON-NUMERIC 
CHARACTER IN NUMERIC FIELD 

While processing a SEND command, 
IDEAcomm 3278 has attempted to put 
non-numeric data into a numeric~only 
field on the screen. The current SEND 
operation is ended. 


Correct the file and SEND the file 
again. You must also SEND any files 
specified in the SEND command after the 
bad file. All files preceding the bad 
file have been sent successfully. 
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IDEAcomm 3278-918 IDEAcomm 3278 
RESIDENT - EXIT IGNORED 

You have entered an EXIT command while 
IDEAcomm 3278 is resident (i.e., after 
_ pressing both SHIFT keys to make 
IDEAcomm 3278 resident in memory). 


To exit IDEAcomm 3278 when it is 
resident, you must GO into 3278 
Emulation Mode and press both SHIFT 
keys at the same time. To make 
IDEAcomm 3278 non-resident again, you 
must reboot the O/S. 


Diagnostic Messages 


TEST3278-001 ‘ALL IDEAcomm 3278 
FUNCTIONS COMPLETE 

All the diagnostic routines ran to 
completion without error indicating the 
hardware is functioning properly. 


TEST3278-802 IDEAcomm 3278 NOT IN 
SYSTEM 

There was no response to the host 
microcomputer I/O request indicating 
that the IDEAcomm 3278 board may not be 
installed in the system. 
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TEST327 8-083 WCS INSTRUCTION MEMORY 
ERROR 

In trying to write to the instruction 
memory of IDEAcomm 3278 problems were 
encountered indicating a possible bad 
instruction memory IC or I/O switch 
setting error. 


TEST3278-004 8X385 ADDRESS ERROR 
This indicates some problem with the 
8X305 microcontroller's ability to 
address the instruction memory. 


TEST3278-6895 ° 8X385 I/O ERROR 

This indicates a problem with the 
ability of the 8X385 microcontroller to 
perform I/O to the control port of the 
host microcomputer. 


TEST327 8-006 HOST SCREEN MEMORY 
ERROR | 

The dual-port screen memory that is 
resident on the IDEAcomm 3278 hardware 
does not pass a memory test from the 
host microcomputer side of the : 
interface. This indicates a possible 
problem with the screen memory 
Circuits, the dual-port access 
circuitry, or a memory switch error. 
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TEST327 8-007 8X385 SCREEN MEMORY 
ERROR 

This indicates a problem with the 8xX39@5 
microcontroller's ability to modify 

the screen memory from within the 
IDEAcomm 3278 hardware, indicating a 
problem with the internal bus drivers 
and control circuitry. 


TEST3278-908 8X395 8K OFFSET JAM 
ERROR 

This indicates a problem with 8X3@5 
microcontrollers’ ability to modify the 
screen memory with a unique data 
pattern. This indicates that the 
problem is in the internal bus driver 
and control circuitry. 


TEST3278-809 = IRMA SIMULATION ERROR 
This indicates a problem sequencing the 
board and host through a short dialog 
using all the IRMA type data passing 
and handshaking. 


TEST3278-919 AUTO RESPONSE LOOPBACK 
FAILED 

This indicates a problem with some 
component between the LSI support 
Circuits and the coax connector, 
possibly the relay. 


TEST327 8-911 DIGITAL COAX LOOPBACK 
FAILED 

This indicates a problem with the LSI 
coax support circuits. 


TEST3278-912 ANALOG COAX LOOPBACK 
FAILED 
This indicates some problem with the 
analog components between the LSI 
support circuits and the coax 
connector. 

Software Messages A-9 
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Technical Information 


IDEAcomm 3278 Hardware System Overview 


The IDEAcomm 3278 communications 
package exists in the PC as four 
contiguous ports in the I/O space and 4 
kbytes of dual-port RAM in the memory 
Space. The I/O ports are used for 
controlling the high-speed, on-board 
8X385 microcontroller and for 
downloading the 8X305 instructions to 
its instruction memory. The 4 kbytes of 
dual-port RAM are used for storing the 
image of the emulated 3278 screen. 

This screen image is updated by the 

_ 8X385 in real time as instructed by the 
IBM 3274 or 3276 Control Unit connected 
to the other end of the coax cable. 

The PC must read the screen image in 
the dual-port RAM, convert it into’ the 
proper format, and finally display it 
on the physical screen for you to see. 
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Diaqnostic Overview 


The diagnostic tests should be | 
performed if you suspect a problem with 
your card or PC, when changes are made 
to switch settings, or when new cards 
Or hardware are added to your system. 
The IDEAcomm 3278 hardware diagnostics 
determine if the IDEAcomm 3278 card and 
your PC are fully functional. 


The diagnostic tests are performed in 
the following order: 


®. Ability of the PC to address the 
IDEAcomm 3278 card I/O port. 


1. Read/write memory address test of 
the 8X395 instruction memory 
(writable-control-store). 


2. Ability of the 8X385 to run a simplé 
program. | 


3. PC's read/write access to the screen 
memory resident on the IDEAcomm 3278 
card. 


4. 8X305 read/write access to the 


screen memory resident on the 
IDEA3278 card. 


B-2 Technical Information 


8X3085 ability to write unique 


pattern using 8K jam in the screen 
Memory. | 


IRMA compatibility test setting up 
IRMA type dialog using all the 
appropriate flags. 


Ability of IDEA3278 board to respond 
to poll requests from host. 


Ability of the coax support circuits 
resident on the IDEAcomm 3278 card 
to perform a digital loopback test. 


Ability of the coax support circuits 


resident on the IDEAcomm 3278 card 
to perform an analog loopback test. 
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Performing Indjvidua] Diagnostic Tests 
If necessary, you can test specific 
hardware components using the 

. TEST3278/1 Diagnostic Tests. 


To allow this level of testing, type 
the following: 


TEST3278 /1 
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The following menu is displayed: 


IDEA3278 Diagnostic Program 
Copyright(c) 198x IDEAssociates Inc. 
Version x.xx 


Select Test Option: 


(8) Host micro I/O control port. 
(1) 8xX385 instruction memory/addressing. 
(2) 8X385 I/O addressing. 

(3) Host micro screen memory. 
(4) 8X385 screen memory. 

(5) 8X305 8K offset jam. 

(6) IRMA simulation. 

(7) Auto response loopback. 

(8) Coax digital loopback. 

(9) Coax analog loopback. 

(X) Exit IDEA3278 diagnostics. 


2=> <-- 


Figure B-l: Diagnostics Menu 
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Type in the number of the option you 
wish to choose. The test begins 
immediately. The test is performed 
continuously until you press any key. 
Pressing any key stops the test and 
displays a message telling you that the 
test was passed, or a diagnostic error 
message indicating the type of failure 
found. 


After receiving a passed or failed 
message, press any key to continue. 
Type X to end the IDEAcomm 3278 
diagnostics. 


If you received an error message, refer 


to Appendix A for a description of that 
message. 
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Product Specifications 


Descriptions 

One controller card for the IBM PC, XT, 
AT or portable provides linkage to IBM 
3274/3276 controllers. Software 
includes: 


o Runtime emulation program: IDEAcomm 
3278 


o Off line diagnostic program: 
TEST3278 


o Off line configuration program: CFIG 


o Off line configuration program: HFIG 
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Prerequisite: 


o IBM PC, XT, AT, Or portable with 
128K memory. 
o IBM terminal controllers: 

3274 with type "A" adapters. 
Channel attached. 

SNA/SDLC or BSC remote. 

3276 Remote terminal controller, 
SNA/SDLC or BSC Mainframes with 
integral type "A" adapters. 

Compatibility: | 
Complete emulation of IBM 3278 
terminals: 

o 2.5 Megabits/second. 

Oo coax attached. 

Oo On-board controller computer 


requires no intervention by IBM PC 
8088. 
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Softwares: 


Oo 


Capture screens of data with IBM 
327@ attributes. 


Local print to file or IBM PC or 
control unit printer. 


Keyboard can be remapped by user. 
Simulate power off when in Emulation 
Mode for security or stay on line 
for convenience. 


Extensive diagnostics. 


Microcode is loaded from a disk for 
ease of updating. 


Full screen access to 3278/9 display 
MeMOry . 


Physical Dimensions: 


oO 


13 1/4" x 4" x 1/2". 


Single PC Board: 


Oo 


Fits into any full size slot. 
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Powers 
o 2.8 Amp at +5 Volts. 
Cable Connectors: 


o BNC connector on back panel attaches 
to RG-62U coaxial cable. 
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Appendix C: 


File Transfer Facility (XFER) 


The auxiliary program XFER can be used 
in conjunction with IDEAcomm 3278 to 
transfer files between your Personal 
Computer and a VM/CMS or TSO 
environment. 


The IDEAcomm 3278 program allows 
communications to be established 
between your personal computer and the 
host. It causes your personal computer 
to appear to both you and the host to 
be an IBM 3278 terminal. Once IDEAcomm 
3278 is resident, when you exit 
IDEAcomm 3278 and run XFER, the host 
still sees your personal computer as a 
3278 terminal, which enables XFER to 
transfer data between your computer and 
the host. 
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Running XFER 


The file IDEA3278.UCM is required by 


XFER and must be present on the default 
disk. | 


To use XFER, you must first run 
IDEAcomm 3278. Log on to the host and 
be at the TSO or CMS command level. 
Exit from IDEAcomm 3278 to DOS by 
making IDEAcomm 3278 resident by using 
the hot key. Do not use the EXIT 
command because IDEAcomm 3278 will not 
become resident. 


( A>XFER <CR> 
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XFER will begin executing and will 
display the following menu: 
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ZJaysueiy, xe[ttdJ p-o9 


IDEA3278 File Transfer System - Ver. X.XX = October xx, 198x 
COPYRIGHT(C) 198x, 198x, IDEAssociates, Inc. 
COPYRIGHT(C) 198x, Micro Integration, Inc. 


Fl - SEND FILE TO HOST 
F2 - RECEIVE FILE FROM HOST 


F5 <- EDIT INITIALIZATION PARAMETERS 


PILE MODE - T <TEXT> RECORD LENGTH (1-255) - 255 
RECORD FORMAT = V <VARIABLE> PC File eseeneeaceeceseeeeose 
BOST FILE  M ee eereseesoeereoos 


XPER-828 FiI@-EXIT 


SELECT FUNCTION 


Figure D-l: XFER Menu 


To select an option from this menu, 
press the appropriate function key 
(Fl), (F2), (F5), or (F190). 


To exit XFER and return to the 
operating system, press (F108). You 
cannot exit while in the process of 
sending or receiving a file. 


Editing the Parameters 


Before transferring a file you must 
specify the initialization parameters. 
To do this, press the F5 key. The 
cursor will go into FILE MODE field on 
the menu and the SELECT FUNCTION 
message is replaced by the message: 


Press TAB for next field, CR to end 
edit 


You can edit any parameter by pressing 
the TAB key to move the cursor to the 
field for that parameter and then 
typing in the new value. When you TAB 
out of the HOST FILE field the cursor 
will go into FILE MODE field, so you 
can cycle through the list of 
parameters as often as you wish. 
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When you type a character into the 
first position of a field that already 
has a name in it, XFER covers the rest 
of the field with blocks. Pressing the 
backspace key erases the character 
before the cursor and backs up the 
cursor one position. If you backspace 
from the first position in a field, 
XFER will restore the original value 
that was present when you came into the 
field. You may also restore the 
Original value by entering CTRL C at 
any position in a field. If you - 
attempt to enter an invalid character, 
XFER will not: accept the character. 


File Mod 
The FILE MODE may be. either text or 
binary. 


Text file mode should be used for 
transferring files containing only 
ASCII characters, field Beka stores and 
record separators. 
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Since characters with a hexadecimal 
value greater than 7FH (127) cannot be 
transferred, files containing such 
characters must be transferred in 
binary file mode. When a file is sent 
to the host in binary mode, each byte 
to be transmitted is translated into 
two bytes, both less than 7FH. To 
convert back to the original 
characters, the file must then be run 
through a translation program on the 
host or be received from a host by 
another personal computer running XFER 
in binary file mode. When a file is 
received from the host in binary file 
mode, each pair of bytes is translated 
into a single byte. 


NOTE 


Specifying binary file mode 
automatically selects fixed record 
format and record length 88. The 
record length and record format 
shown on the menu are ignored. 
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Record Length 


When transferring files with variable 
length records, you should use variable 
format and record length 255. XFER 
uses record separator characters in 

the file to determine the end of each 
record. Records longer than the 

length you specify will be broken up 
and will be transferred as two or more 
partial records. 


Files with fixed length records may or 
may not contain record separators. 

When transferring these files, you 
should use fixed format and specify the 
actual record length. Short records 
will be padded to the specified length. 


PC File 


For the PC file you may specify any 
filename that is valid on DOS, up to 14. 
Characters. If the file specified for 
a send operation does not exist, XFER 
will display an error message when you 
attempt the send operation. If the 
file specified for a receive operation 
already exists, XFER will give you the 
option of deleting and over-writing the 
file or specifying a different 
filename. 
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Host File 


You may specify any filename that is 
valid for the host system, and it can 
contain up to 44 characters. If the 
file specified for a receive operation 
does not exist on the host, XFER will 
display an error message when you 
attempt the receive operation. If the 
file specified for a send operation 
already exists on the host, XFER will 
give you the option of deleting and 
over-writing the file, or specifying a 
different filename. 


Ending the Edit 


After you have specified all 
parameters, press the ENTER key. XFER 
will store the values shown on the 
menu, the SELECT FUNCTION message will 
appear again, and you are ready to 
transfer the file. 


Transferring a File 


To send the data from the PC file to 
the host and write it to the specified 

_ host file, press the Fl key. To 
receive the data from the host file and 

write it to the specified PC file on 
heels personal computer, press the F2 
ey. 
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After you press the Fl or F2 key it 

will take a moment for the host to get 
ready for the transfer operation. The | 
message: 


f XFER-@26 INITIALIZING HOST 


will appear to let you know that the 
initialization is proceeding. If for 
some reason the host cannot be 
initialized you will see an error 
message. 


When the host is ready, XFER will 
display a message to indicate that the 
file transfer is taking place. 


During file transfer, the F198 key does 
not cause XFER execution to terminate, 
but it can be used to interrupt file 
transfer. If you press F1®8 during the 
file transfer, XFER will display the 
message: 


XFER-@13 KEYBOARD INTERRUPT - 
CONTINUE (<Y> or N)? 
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If you reply N, the transfer will stop 
and the messages: 


XFER-829 FUNCTION ABORTED BY 
OPERATOR 


and: 


SELECT FUNCTION 


will be displayed. If you reply Y, the 
file transfer will resume and the 
number of bytes transferred is 
displayed on the screen. 


When the file has been transferred, 
the messages: 


( XFER-818 FILE TRANSFER COMPLETE 


ands 


( SELECT FUNCTION | 


will appear. If you wish, you may 
specify new parameters and do another 
transfer. 
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Terminating XFER 


After you have completed all desired 
transfers, press the (F189) key to exit 
XFER and return to the operating 
system. 


Batch Mode 


You may run XFER as a batch program, 
rather than interactively, by 
Specifying the transfer parameters on 
the command line. You may do this by 
entering the XFER command line and 
parameters directly on your personal 
computer console, or by including the 
command line in a batch file. 


The XFER command line has the syntax: 


XFER 
EAs ce Ooi aicas dee ieecnatenne 
]}<PCfilename><hostfilename> 
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<direction> 
Specifies the direction of file 
transfer. 


UPLOAD, UP, Specifies that data is to 
or U be sent from the PC file 
to the host file. 


DOWNLOAD, Specifies that data is to 
DOWN, or D be received from the host 
file to the PC file. | 


/R 

Indicates that the XFER program is to 
remain active after the file transfer 
Operation. After the transfer is 
complete, XFER will go into interactive 
mode. XFER will also remain active if 
certain errors occur which prevent the 
file transfer from aborting. However, 
some errors cause XFER to terminate 
even if /R is specified. 


If /R is omitted, then XFER terminates 
after the file transfer. 
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<mode> 


Specifies the file transfer mode. 


TEXT or T 


BINARY, 
BIN, or B 


<format> 


Specifies that the file is 
to be transferred in text . 
mode. 


Specifies that the file is 
to be transferred in 
binary mode. 


If both TEXT and BINARY 
are omitted, TEXT is 
assumed. 


Specifies the record format for the 
file transfer. 


VARIABLE, 
VAR, or V 


FIXED, 
FIX, or F 


Specifies variable record 
format. 


Specifies fixed record 
format. 


If both VARIABLE and FIXED are omitted, 
VARIABLE is assumed. 
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RL =#=nnn 

Specified record length, where nnn is 
in the range 1 to 255. If this 
parameter is omitted, record length 255 
is assumed. 


<PCfilename> 

Specifies the name of the file on your 
personal computer system to or from 
which data is to be transferred. 


<Hostfilename> 

Specifies the name of the file on the 
host system to or from which data is to 
be transferred. 


The host filename consists of all 
characters, including spaces, between 
<PCfilename> and the end of the XFER 
command line. (Spaces are valid 
characters in filenames on some 
hosts.) 


The parameters may be separated by any 
combination of spaces, tabs, and 
commas. The meaning of the parameters 
is explained in this section under 
"Editing the Parameters". 


The command line must be terminated by 


a <CR>, and may be longer than 898 
Characters. 
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The XFER program recognizes parameters 
by means of keywords, so it is not 
necessary to enter any delimiters for 
parameters which are omitted. However, 
1f you omit parameters you may not use 
filenames which match the keywords. 

For example, 1f£f you omit format and 
record length, you may not specify a PC 
filename of VAR. 


After completing the file transfer 
specified by the command line 
parameters, XFER terminates execution 
and returns control to the DOS 
operating system (0/S). 


If XFER is executed from a batch file, 
XFER returns an error code to the PC's 
batch processor equal to the message 
number of the XFER console message for 
that error. The batch processor may be 
programmed to process the error codes. 
If no error occurs, XFER returns an 
error code of zero. 
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EXAMPLE: 


Create a file called MYXFER.BAT 
containing: 


XFER U B F RL=89 SALES.MON 
STORE523 SALES 


XFER D A:DATA.@891 DATA.@91 


Run IDEAcomm 3278, logon to your host 
system, and exit IDEAcomm 3278. Type 
the following: 


( A>MYXFER <CR> 


On your console. Your personal 
computer will execute XFER twice. 
First, the file SALES.MON will be sent 
from the currently logged disk on your 
personal computer to the file STORE523 
SALES on the host system, transmitted 
in binary mode, with fixed length 88 
byte records. Next, the file DATA.001 
on the host system will be received 
into the file DATA.@81 on drive A on 
your personal computer, in text mode 
with variable record format and record 
length 255. Control is then returned 
to DOS. 
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XFER Program Messages 


The XFER program displays messages to 
inform you of various conditions. When 
applicable, these messages will appear 
on the XFER menu near the bottom of the 
screen. 


All messages are of the form: 


XFER-nnn message text 


nnn is unique message identifier 
that provides easy reference 
to the message explanation in 
this chapter. 


message is a short message briefly 

text describing the action 
required, condition found, or 
program status. 


Whenever the message asks for a yes or . 
no (Y or N) reply, the default value 
will be displayed enclosed in angle 
brackets:<>. If you enter <CR>, or 
enter anything other than Y or N, XFER 
will take the default. 


A list of the messages and a brief 
description of each is given below. 
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XFER-901 IDEA3278.UCM NOT FOUND ON 
DEFAULT DRIVE 

The IDEA3278.UCM file, which is 
required by XFER, was not found on the 
disk on the default drive. 


Ensure that the file is present and 
that you are executing XFER from the 
proper disk. Run XFER again. 


XFER-9@2 ERROR READING IDEA3278 .UCM 
An I/O error occurred while XFER was 
trying to read the configuration file 
IDEA3278.UCM. 


XFER-993 BAD RECORD LENGTH - 
RE-ENTER 

A record length not in the range 1-255 
bytes was specified on the menu. 


Specify a valid record length. 


XFER-8@04 NO PC FILE SPECIFIED 

You must specify the name of a file on 
your personal computer for the send or 
receive operation. 


XFER-@885 NO HOST FILE SPECIFIED 

You must specify the name of a file on 
the the host system for the send or 
receive operation. 
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XFER~8 96 NOT AT RECOGNIZABLE COMMAND 
LEVEL | 

To perform a file transfer, you must be 
logged onto TSO or VM and be at command 
level. 


Go into IDEAcomm 3278 Emulation Mode 
and get back to command level by 
pressing the key configured as the EXIT 
key. (The default EXIT key is CTRL E.) 


XFER-007 HOST STATUS TIMEOUT - 
CONTINUE (<Y> OR N)? 

The host has not responded to a 
transmission within 15 seconds. 


Reply Y if you wish to continue; reply 
N if you wish to abort. If this 
message occurs frequently, you should 
reply N and investigate the cause. If 
this message recurs immediately, you 
may not be connected to the host or the 
keyboard may be locked. 


NOTE 
Each time you reply Y to this 


message, the time-out interval is 
increased by 5 seconds. 
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XFER-8988 CONTROL UNIT TIMEOUT - 
CONTINUE (<Y¥> OR N)? 

The control unit was unable to accept 
data from your personal computer. 


Reply Y if you wish to continue; reply 
N if you wish to abort. 


You may not have run IDEA3278 before 
running XFER. 


XFER-899 HOST FILE CLOSE ERROR - 
FUNCTION ABORTED 

The host system was unable to close the 
host file and save your data set after 
a send operation. The filename which 
you specified for <hostfilename> in the 
send operation is a valid filename, but 
you are not allowed to access it. 


Specify a different host filename and 
send the file again. 
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XFER-819 PC FILE OPEN ERROR - 
FUNCTION ABORTED 

XFER was unable to open the PC file you 
specified for a send or receive 
operation. . 


For a send operation, this means that 
the file does not exist. For a receive 
operation, the disk directory may be 
full. 


XFER-811 PC FILE I/O ERROR - 
FUNCTION ABORTED 

An I/O error occurred on a PC file 
during a send or receive operation. 


The disk may be full or you may have a 
bad sector. 


XFER-012 HOST FILE OPEN ERROR - 
FUNCTION ABORTED 

XFER was unable to open the host file 
specified for a send or receive 
operation. 


XPER-6813 KEYBOARD INTERRUPT - 
CONTINUE (<Y¥> OR N)? 

You have pressed the F1@ key during a 
file transfer operation. 


Reply Y if you wish to continue the 


operation; reply N if you wish to 
abort. 
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XFER-814 HOST NOT RESPONDING AS 
EXPECTED ~ FUNCTION ABORTED 

During a send or receive operation, 
the host system has not responded 
properly. XFER has aborted the 
transfer operation. 


Go into IDEAcomm 3278 and investigate 
the cause. Ensure that you are at the 
TSO or VM command level. See if any 
messages have been received to the 
terminal screen. | 


XFER @15 INVALID BINARY FILE - 
FUNCTION ABORTED 

A file being received from the host in 
binary file mode contains invalid 
Characters. See the discussion of file 
mode earlier in this chapter. 


XFER 616 INVALID DRIVE SPECIFIED - 
RE-ENTER 

The disk drive specified for a PC file 
is not in the range A through P. 


Enter a valid drive identifier. 
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XFER -6817 FILENAME NOT UNIQUE 
(CONTAINS WILDCARDS) - RE-ENTER 

You may transfer only one file at a 
time. You may not use “wildcard” 
Characters in filenames to transfer a 
whole group of files. For example, 
COAXDAT.* is a illegal filename for 
XFER. 


Specify a unique filename containing no 
"wildcard" characters. 


XFER-918 FILE TRANSFER COMPLETE 

A send or receive operation has been 
successfully completed. XFER is ready 
for you to select another function. 


XFER-9819 PC FILE ALREADY EXISTS - 
DELETE (Y OR <N>) 

A PC file specified for a receive 
operation already exists. 


Reply Y to delete the file and 
over-write it with the new data 
received from the host. Reply N to 
preserve the existing file, then 
specify a new PC file for the receive 
operation. 
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XFER-9 28 FUNCTION ABORTED BY 
OPERATOR 

You have aborted a send or receive 
Operation, for example, by pressing the 
F198 key and then answering N when 
asked if you want to continue. 


XFER-@21 RECEIVE FILE CREATION ERROR 
- FUNCTION ABORTED 

XFER was unable to create the PC file 
specified for a receive operation. 


The disk may be read-only. The disk 
may have a bad sector. The disk or 
directory may be full. 


XFER-922 FILE DELETION ERROR -~ 
FUNCTION ABORTED 

XFER’ was unable to delete a-file. 
The disk may be read-only. 


XFER-923 FILENAMES NOT SPECIFIED 
You have not specified both a PC file 
and a host file for a send or receive 
operation. 


Enter the required filename(s). 
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XFER-924 BYTES RECEIVED nnnnn 

This message indicates the number of 
bytes received from the host during the 
current transfer operation. 


XFER-025 (F189) - INTERRUPT 

This message is on the screen during a 
send or receive operation to indicate 
that the F118 key may be used to 
interrupt the transfer operation. 


XFER-6 26 INTITALIZING HOST 


XFER is preparing the host for a file 
transfer operation. 


XFER-927 RESTORING HOST 
CONFIGURATION 

After a file transfer, XFER is 
restoring the host system to its 
previous configuration. 


XFER-928 F1@ - EXIT 

This message is on the screen when XFER 
is not in the process of transferring a 
file, to indicate that the F1@ key may 

be used to exit XFER. 


XFER-929 BYTES SENT TO HOST nnnnn 
This message indicates the number of 
bytes sent to the host during the 
Current transfer operation. 
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XFER-830 HOST FILE EXISTS - DELETE 
(Y OR <N>)? 

A host file specified for a send 
operation already exists. 


Reply Y to delete the file and 
overwrite it with the new data sent 
from the PC file. Reply N to preserve 
the existing file, then specify a new 
host file for the send operation. 


XFER-931 COMMAND LINE ERROR - 
FUNCTION NOT RECOGNIZED - FILE TRANSFER 

ABORTED 

Something other than UPLOAD, UP, U, 

DOWNLOAD, DOWN, or D was specified as 

ae first parameter of the XFER command 
ine. 


XFER-832 © COMMAND LINE ERROR - 

INVALID RECORD LENGTH - FILE TRANSFER 
ABORTED 

A record length not in the range 1 to 
255 was specified in the RL = parameter 
in the XFER command line. 


XFER-933 © COMMAND LINE ERROR - 
INVALID PC FILE NAME - FILE TRANSFER 
ABORTED 

The syntax of the filename specified 
for the <pcfile> parameter of the XFER 
command line is incorrect. 
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XFER-0@34 COMMAND LINE ERROR - NO 
HOST FILE SPECIFIED - FILE TRANSFER 
ABORTED 

No filename was specified for the 
<hostfile> parameter in the XFER 
command line. 


XFER-935 COMMAND LINE ERROR - 
INVALID CHARACTER ~-. FILE TRANSFER 
ABORTED 

The XFER command line contains a 
character other than displayable ASCII 
Characters or the tab character. 


XFER-@36 COMMAND LINE ERROR - 
MISSING PARAMETERS - FILE TRANSFER 
ABORTED 

A required parameter has been omitted 
from the XFER command line. You are 
required to enter the <direction>, 
<pefile>, and <hostfile> parameters. 


XFER-937 COMMAND LINE ERROR - EXTRA 
CHARACTERS - FILE TRANSFER ABORTED 
Characters have been found in the XFER 
command line following the <hostfile> 
parameter. The <hostfile> may be 
longer than 44 characters, or the 
command line may not be terminated by a 
<CR>. 
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XFER-838 EXITED XFER FILE TRANSFER 

In response to the F180 key, XFER has 
ended execution and returned you to the 
operating system. 
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Appendix D: 


IDEA3278 Support Subroutines in BASIC. 


This appendix should be used by anyone 
who wants to customize their software 
to run with the IDEAcomm 3278 card. 


IDEASUPP.BAS is a Basic Program | 
consisting solely of subroutines to aid 
you in interfacing your own code with 
the IDEAcomm 3278 card. 


There are five files related to the. 
Basic support subroutines: 


1. IDEASUPP.BAS Basic subroutines 
sparsely commented. 


2. IDEASUPP.LST Commented list file 
of Basic 
subroutines. 


*3. ASDISTBL.DAT ASCII to display 
data file. 


*4. DSPTBL.DAT Display to ASCII 
data file. 


*5. ASCSCAN.DAT ASCII to scan code 
data file. 


*These files are used in the 
Initialization Subroutine and must be 
present on disk when running the 
Initialization Subroutine of 
IDEASUPP.BAS. 
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The following pages provide you with 
three lists: 


o Subroutines and Descriptions 
o Reserved Variables 
o Error Code Definitions 


as well as Notes to Users. 


ROUTINE: INIT (Initialize) 
LINE #: 50800 


DESCRIPTION: Table initialization 


INPUT None 

VARIABLES: 

OUTPUT None 

VARIABLES: 

COMMENT: Must be executed prior to 


general use of other 
subroutines. 
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ROUTINE: XPOR (Execute Power On 
Reset) 


LINE #: 501080 


DESCRIPTION: Resets IDEAcomm 3278 card 


INPUT None 

VARIABLES: 

OUTPUT None 

VARIABLES: 

COMMENT: Used for reactivating 


IDEAcomm 3278 
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ROUTINE: STDNM (Set Trigger Location 


And Mask) 
LINE #: 


DESCRIPTION: 


INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT: 


58400 


Set trigger of a given 
bit pattern at a given 
location 


I. VRO% - Row 
I.VCL% - Column 
I.VMS% - Mask Value 


I. VER3% Error Code 


The mask causes a trigger 
when the bits specified 
in the mask are set to l 
in the byte at the 
specified location. A 
mask of @OFFH will trigger | 
only when the value . 
I.VVL% matches the value 
at the specified 


location. A mask of 9 


will trigger on any 
change of the value at 
the specified location. 
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ROUTINE: WTRIG (Wait For Trigger) 
LINE #: 50500 


DESCRIPTION: Wait for trigger 


INPUT I.VTO&® - Maximum Time To 
VARIABLES: Wait In Seconds. 

OUTPUT I.VER% - Error Code 
VARIABLES: I.VTO&% - Time Left From 


Total Time Allowed 


COMMENT: _ Used in conjunction with 
STDNM. Waits until bits 
in mask specified in 
STDNM are on in location 
specified in STDNM. 
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ROUTINE: KEYS (Send Keystrokes) 


LINE #: 
DESCRIPTION: 
INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT: 


ROUTINE: FIND 


LINE #: 
DESCRIPTION: 


INPUT 
VARIABLES : 


50608 


Send ASCII string as a 
series of keystrokes 


I.VST$ - 1/0 String 
I.-VER% =- Error Code 


Used for emulating | 
keyboard input. 


(Find Field) 
50708 


Find specified 
unprotected field on 
IDEAcomm 3278 screen 


I. VFL3 = Field Number. 
Routine is to find the 
I.VFL%th unprotected 
field. 
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OUTPUT 
VARIABLES: 


COMMENT: 


I.VER% - Error Code 


I.VCB% - Pointer To 
Leading Attribute 


I.VCE% - Pointer To 
Trailing Attribute 


I.VFS% - Length of Field 


I.VRO% - Row of first 
byte in field after 


leading attribute 


I.VCL% - Column of first 
byte in field after 
leading attribute 


I.BUF%(9) - Internal 
Buffer. Contains leading 
attribute 


FIND counts and accesses 
only unprotected fields. 
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ROUTINE: FNEXT (Find Next Field) 
LINE #: 59800 


DESCRIPTION: Find next unprotected 
field 


INPUT I.VFL% - Field Number 
VARIABLES: 


OUTPUT I.VER% =~ Error Code 
VARIABLES: 
I.VCB% - Pointer To 
Leading Attribute 


I. VCE% - Pointer To 
Trailing Attribute 


I.VFS% ~- Length of Field 


I.VRO& - Row of first 
byte in field after 
leading attribute. 


I.VCL% - Column of first 
byte in field after 
leading attribute. 


I.BUF%(9) - Internal 
Buffer. Contains leading 
attribute. 


COMMENT: Field number is 


incremented and FIND is 
executed. 
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ROUTINE: RDFLD (Read Field) 


LINE #: 


DESCRIPTION: 


INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT : 


58996 


Field is read from 
IDEAcomm 3278 buffer into 
internal buffer 


I.VCB% - Pointer to 
Leading Attribute 


I.VFS% - Length of Field 


I.BUF%() - Internal 
Buffer 


Should be called only 
after FIND or FNEXT. 
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ROUTINE: WRFLD (Write Field) 


LINE #: 


DESCRIPTION: 


INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT: 


51800 

Write field from internal 
buffer to IDEAcomm 3278 
Buffer. Set the Modified 
Data Tag. 


I.BUF%() - Internal 
Buffer 


I.VCB% ~- Pointer to 
Leading Attribute 


I.VFS% ~- Length of Field 
I.VER% - Error Code 


Usually called after FIND 
and PUTSTR. 
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ROUTINE: GTSTR (Get String) 


LINE #: 


DESCRIPTION: 


INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT: 


51199 


Convert internal buffer 
into ASCII string. 


I.BUF%() - Internal 
Buffer 


I.VFS% - Length of Field 

I.VOO% - Offset 

I.VER% - Error Code 
I.vst$ - 1/0 String 


I.VOO% - Offset 


Returns character string 
of up to 254 characters. 
If field length is : 
greater than 254 then 
I.VOO% points to next 
osition in buffer. Used 
n conjunction with FIND 
and RDFLD. 
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ROUTINE: PUTSTR (Put String) 


LINE #: 


DESCRIPTION: 


INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT: 


51200 


Put ASCII string into 
buffer. 


I.VST$ - 1/0 String 
-I.VOO&’ - Offset 
I.VER® - Error Code 
I.vVOO%’ - Offset 


I.BUF%() - Internal 
Buffer 


Used in conjunction with 
WRFLD and FIND to load 
fields into IDEAcomm 3278 
buffer. 
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ROUTINE: RDABSR (Read Absolute 
Address) 


LINE #: 51308 


DESCRIPTION: Convert IDEAcomm 3278 
| display to string. 


INPUT I.VRO% - Row 

VARIABLES: 
I.VCL% - Column 
I.VRR& - Number of 
Positions 

OUTPUT I.VER% - Error Code 

VARIABLES: | 

| I.VRO& =- Row of 


character after last 
character read. 


I.VCL%® - Column of 
character after last 
character read. 


I.VST$ - I/O String 
COMMENT: Used for access to status 
line and protected 


fields. Status Line is 
Row @. 
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ROUTINE: GTCP (Get Cursor Position) 


LINE #: 51406 
DESCRIPTION: Return current cursor 
position 
INPUT None 
VARIABLES: | 
OUTPUT I.VER% - Error Code 
VARIABLES: 
I.VCL% - Column 
I e VRO$% - Row 
COMMENT: If IDEAcomm 3278 is in a 


changing state then 
I.VRO% may be out of 
range. If so, GTCP 
returns an error code. 
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ROUTINE: ALSTAT (Align Shift 


Status) 
LINE #3. 


DESCRIPTION: 


INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT: 


52000 


Sends scan code and shift 
status code to IDEAcomm 
3278. 


I.SHIFT% - Shift Status 
I.SCAN% - Scan Code 
I. VER% - Error Code 


I.SHIFT% should contain 
64 if the scan code is 
SHIFTed, 128 if the scan 
code is ALTed, 9 if 
neither SHIFTed or ALTed. 
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ROUTINE: SSCANT (Send Scan Code) 


LINE #: 
DESCRIPTION: 
INPUT 
VARIABLES: 


OUTPUT 
VARIABLES: 


COMMENT : 


52208 


Send scan code to 
IDEAcomm 3278 


I.SCAN% - Scan Code 
I. VER% - Error Code 


Time out will occur in 
approximately one second 
if scan code is not 
taken. 
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ROUTINE: VRC 
LINE #: 
DESCRIPTION: 


INPUT 
VARIABLES : 


OUTPUT 
VARIABLES: 


COMMENT : 


(Verify Row Column) 
52500 


Verify row and column 
variables 


I.VCL% - Column 
I.VRO - Row 


I.VER% - Error Code 


Determines whether row 
and column are within 
valid range and returns 
result in I.VER%. If 
both row and column are 
out of range, returns 
“row out of range." 
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RESERVED VARIABLES 


The following variables should NOT BE 
CHANGED : 


I .DOWNALTS | 
I .UPALT? 
I.DOWNSHIFT% 
I. UPSHIFT% 
I.DISASC% 

I .ASCMS$ () 
I.ASCAN$ () 
I. TRIG% 

I. TMASK% 

I. VAL% 
I.CSHIFT% 
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The following variables may be changed, 
but must be USED AS INTENDED. For 


example, 


I.VCL% must always contain a 


valid column address and should not be 
used for something like storing scan 


codes. 


I. VCL% 
I « VRO% 
I. VCB% 
I. VCE% 


I. VER% 
I.VSTS 
I.VFS% 
1. VFL3 
I. VVL$% 
I. VMS3 
I .SHIFT3 
I .SCAN3 
I. VVR% 
I. VOO3 
I .BUFS () 


Column 

Row | 

Pointer to Leading Attribute 
Pointer to Trailing 
Attribute 

Error Code 

I/O String 

Length of Field 
Field Number 

Value 

Mask Value 

Shift Status 

Scan Code 

Character Length 
Offset 

Internal Buffer 
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The following are temporary variables 
used within subroutines only. These 
variables should noe BE USED FOR LONG 
TERM STORAGE. 

I. TEMPS 

I.TEMP1$ 

I .TEMPS 

I .ABS% 

I.X% 


I .COUNT 
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ERROR CODE DEFINITIONS 


& 


NO ERROR 

NOT USED 

ROW OUT OF RANGE 
COLUMN OUT OF RANGE 
NOT USED 

NOT USED 

FIELD ERROR 

FIELD NOT FOUND 


PROTECTED FIELD 


wow onan Ww & W DN FH 


TIME OUT ERROR 


fmt 
& 


TRIGGER TIME OUT ERROR 


— 
pms 


NOT USED 


_ 
N 


FIELD OVERFLOW ERROR 
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NOTES TO USERS 


oO 


The initialization subroutine must 
be executed once prior to using the 
other subroutines. 


If an error occurs (i.e., 

on VER%<>8) , then I.VER% must be set 
to zero prior to another subroutine 
call. 


In using the PUTSTR and GTSTR 
subroutines, I.VOO% must be set to 
zero prior to the subroutine call 
unless the call is in continuation 
of a long field (i.e., field length 
is greater than 254). 


During operation the keyboard may 
become locked. This may be detected 
via a PEEK at location 8. If a 
value of 246 is found then the 
keyboard is locked. 
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Keyboard Locked (Input Inhibited) 
may occur for a variety of reasons. 
The reason is given by the 
characters at locations 9-16 
(columns 19-17 of the status 

line). The characters and the 
conditions which they indicate are 
explained in detail in the IBM 
publications listed in Section I of 
this manual. The most common 
reasons ares 


1. display is in state of 
change, Or 


2. an invalid keystroke was 
sent. 


To check for display in state of 
change (i.e., display is being 
updated by the Host), check for 
Keyboard Locked. Wait a few 

seconds and check again. If the 
keyboard is still locked then the 
display was probably not in state of 
change. 


An invalid keystroke may occur for 
one of several reasons, for example, 
typing a character into a protected 
field, or typing a non-numeric 
Character into a numeric field. 
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The reason is given by the 
characters at locations 9-16 
(columns 18-17 of the status line). 
The characters and the conditions 
which they indicate are explained in 
detail in the IBM publications 
listed in the Section I. 


To remedy this condition, a Reset 
keystroke must be emulated. This is 
done by setting the variables 
I.SHIFT% = @ and I.SCAN% = 52 and 
Calling the subroutine ALSTAT. 


o If the keyboard remains locked for a 
few seconds after a Reset, or if a 
Time Out occurs on the ALSTAT 
subroutine, then it may be necessary 
to reset the IDEAcomm 3278 card. 
This is done by a call to XPOR. 


o If the keyboard remains locked after 
executing XPOR, then some type of 
hardware problem can be assumed. 

For example, the coax cable may be 
disconnected or the control unit may 
be turned off or malfunctioning. 
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Appendix E: 


IDEAcomm 3278 Switch Settings 


Use this appendix if you have a 
conflict with the factory address and 
another board in your IBM PC. Note 
that the factory settings are valid 
whether you have an IBM PC, XT, AT, or 
Portable. 


If you make changes to the I/O address 
or the memory address switches you must 
also change the parameters listed in 
the memory map setup screen (HFIG). 
Refer to Figure E-l. 


Changing Factory Switch Settings 


Switch Bank 1 - Select Interrupt_ 
Request Line to PC 


The factory setting for switch bank 1 


is IRQ5. No other settings are 
appropriate at this time. 


IRQS 


Switch l 2 3 
ON OFF OFF 
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Switch Bank 2 — Memory Address 


The factory settings for switch bank 2 
are D000 and 64K. The following text 
provides additional information. If 
you change your memory address, you 
must change the memory address listed 
in the HFIG file. 


(Switch Address Map) 


Switch No. 
Al4 ------- 6 
Al 5: =s===-= 5 
Al6 ~------- 4 
Al] ---~--- 3 
Al8 ------- 2 
Al9 ------- 1 
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Switches 1 through 4 on switch bank 2 
are used to determine the starting 
memory address (for example, factory 
setting D000). 


Switch 5 and 6 selects the amount of 
screen memory on the card (for example, 
factory setting 64K). 


When switches 5 and 6 are both OFF, the 
setting is 64K. When switches 5 and 6 
are both ON, the setting is 16K. 


Switch Bank 3 - I/O Address 


Switch settings on switch bank 3 are 
set to 2209-227 Hex at the factory. The 
following text provides additional 
information. If you change your I/O 
address, you must change the I/O 
address listed in the CFIG file. 


Note that on switches 1 through 4, only 


the switch you choose should be set to 
ON, the other three switches are OFF. 
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Switch No, I/O Address 


] 220-227 
228-22F 

3 230-237 

4 238-23F 

5 A15 (Same as on Switch 
Bank 2) 

6 Al6 (Same as on Switch 
Bank 2) 


Editing the HFIG File 


Selecting an alternate address setting 
requires two steps: 


1. Change the IDEAcomm 3278 switch 
settings for the I/O or Memory 
address. 


2. Change the IDEA3278.UCM 
configuration file by using the 
HFIG Memory Map Setup (see Figure 
E-1) e 
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To edit the file HFIG to select 
hardware changes, make sure that 
IDEA3278.UCM and HFIG.EXE are on your 
diskette. 


Place the diskette with these files in 
drive A and close the drive door. 


At the prompt type the following: 


( A>HFIG <CR> 


The following screen is displayed: 
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IDEA3278 Memory Map Setup 
Copyright(c) 198x IDEAssociates, Inc. 


V.X XX 
Current Address Desired Address 
I/O Port 227 227 
Screen Buffer peee D8ee 


Select Option 


1) Change I/O Port Address 
2) Change Screen Buffer Address 
3) Exit 


Choices 


Figure E-l: Memory Map Setup Screen 
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If you select Option l, the following 


messages are displayed at the bottom of 
your screen: 


Change I/O Port Address 


Enter three hexadecimal digits: 


[Press Enter to complete; Esc to 
cancel] 


[Valid ports are 227, 22F, 237, 
23F] ; 


If you select Option 2, the following © 


messages are displayed at the bottom of 
your screen: 


Change Screen Buffer Address 
Enter four hexadecimal digits: 


[Press Enter to complete; Esc to 
cancel] 


[Min CO@00, Max EF@O] 
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If you select Option 3, the following 
message is displayed at the bottom of 
your screen: 


Exit to DOS 


Enter Y or Ng 


If you type N, you return to the Memory 
Map Screen. If you type Y, the 
following message is displayed: 


Write Out Desired Addresses [Y or 
NJ: 


If you choose Y, the new parameters you 
entered in the Memory Map Screen are 
written to the IDEA3278.UCM file. If 
you choose N, the new parameters are 
not saved. In either case, your system 
is returned to DOS. 
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Changing IDEAdisk Switch Bank 1] 
Settings 


If you are uSing an IDEAdisk with 
IDEAcomm 3278, you must change the 
address on the IDEAdisk SASI card. For 
example, to change the card address 
from D#BB to E9OB, locate Switch Bank 1 
on your IDEAdisk card. Reset switch 
number 6 to ON. Next move the jumper 
cap on the SASI card to the right-hand 
position. Your address has been 
changed from D#90 to EOOD. 
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Appendix Fs 


Glossary 


Asynchronous communications 
Method of communications whereby data 
is sent as soon as it is ready. 


Asynchronous communications interface 
adapter | 

A device providing the data formatting 
and control necessary to permit 
asynchronous communications with a 
microcomputer. 


ASCII 

American Standard Code for Information 
Interchange, a coding scheme wherein 
letters, numbers, and special symbols 
are represented as unique seven-bit 
values, allowing for standardization 
between data communications devices. | 


Backup 
A duplicate copy of data. 


Batch file 

A file that contains batch commands. It 
is faster to run than retyping the 
commands each time. Such filenames end 
with the extension .BAT. 
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Baud 

Unit related to bits per second, used 
to measure the rate at which 
information moves between computers. 


Bit 

Abbreviation for " binary digit." 

A bit is the smallest unit of 
information recognized by a computer, 
expressed as the digits 1 or 9. 


Bits per second (bps) 

The instantaneous bit speed with which 
a device or channel transmits a 
character. 


Boot 

To bring up or restart the IBM. A 
diskette or partition is bootable if 
it contains the DOS files that will 
start the Bootable. Used of a 
partition or disk to which command 
transfers at startup time. 


Buffer 

Temporary storage, for characters that 
need to be collected pres to 
processing. 
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Cable 
A group of wires connecting two or more 
pieces of equipment. 


Character 
An alphanumeric symbol. 


Connector 

The attachment at the end of a cable, 
by which it connects to the pins in 
another connector. 


Controller 
A board or card that runs a device. 


Data rate 

The speed at which data is sent to a 
receiving computer or device, measured 
in bits per second. 


Dedicated line 

A telephone line or other data link 
with no switching facilities. 
Synonymous with leased line, private 
line, nonswitched line. 
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Dedicated machine 

A PC or other microcomputer designed to 
handle a special, usually single, 

task. A dedicated server PC could only 
be used to service user requests, not 
as both server and workstation. 


Disk controller 
A hardware device that controls a 
physical disk drive. 


Disk operating system (DOS) 
An operating system for the IBM | 
PC/XT/AT and Portable Computers. 


Download 
To transfer information from a host 
computer to another computer. 


Driver 
Software that controls a device. 


EBCDIC 

Extended Binary Coded Decimal 
Information Code, a coding scheme | 
wherein letters, numbers and special 
symbols are represented as unique 
six-bit values, allowing for 
standardization between data 
communications devices; popularized by 
IBM. : 
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Error Detection 
Software routines that identify and 
often correct erroneous data. 


Format 

To prepare a disk so it can be used by 
DOS or another operating system. A 
hard format lays down tracks and 
sectors on a disk. A soft format 
marks sectors that are bad so the 
operating system will not use them. 


Host Adapter Card 

A card that plugs into the IBM system 
board and is connected to a disk drive 
controller by a controller cable. 


Host adapter 

A hardware device that serves as a link 
between the IBM PC and the disk 
controller. 


Host computer 

Primary or controlling computer in a 
multiple computer system upon which the 
smaller computers depend to allocate 
the resources of the system. 


Interrupt 

A processor feature that allows the 
currently executing program to be 
deferred in favor of servicing another. 
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K or KB 
Abbreviation for kilobyte. 1,024 bytes 
(characters) of information. 


MB | 
Abbreviation for megabyte (1 million 
bytes). 


Operand 

An operand is the entity operated 

upon. It is generally designated by an 
address part of an instruction. 


Option memory 
RAM memory located on option boards. 


Parallel transmission 
Simultaneous transmission of all bits 
in a byte. 


Peripheral 
A noncomputing input or output device, 
such as a printer or hard disk drive. 


Protocol 

Rules by which computers exchange 
information, including the organization 
of the units of data to be transferred. 
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RAM 

Random access memory. Items in RAM can 
be randomly retrieved and augmented. 
Each byte can be accessed regardless of 
its location. Information is 
eradicated when the computer is turned 
off. 


Reboot | 
To bring up the operating system in the 
middle of a session. This is 
accomplished by pressing the Ctrl, Alt 
and Del keys simultaneously. 


ROM 
Read only memory, usually a chip used 
for hardware configuration in a system. 


Serial transmission 
Communications method where data is 
sent in a regular pattern of bits. 


Server PC 
Microcomputer used by network as source 
of disk drives and information. 


Synchronous communications 
Communication method where speed and 
flow of information being transmitted 
is controlled by equally spaced clock 
Signals or pulses. 
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System memory 
The amount of RAM installed on the IBM 
PC system board. 


Terminal Mode 


Condition of your PC when it is 
connected to a host computer. 
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Appendix G: 


Customer Support Information 


Repair Policy 


If your product is still under the 
original one year limited warranty, 
IDEA will repair or replace it at no 
charge. If the product is out of the 
warranty period, IDEA will repair it 
and charge you on a time and materials 
basis. 


If you are having problems with your 
IDEA product, take the following steps: 


1. Call your dealer for assistance. 


2. If your dealer is not able to 
provide a solution, call the IDEA 
Technical Support Department at 
(808) 257-5027. (Be sure that you 
have the serial numbers from your 
software diskette and from your IDEA 
hardware.) If the Technical Support 
representative determines that your 
product requires factory service, 
you will be given a Materials Return 
Authorization (MRA) number by 
Technical Support. IDEA will not 
accept returned products without an 
MRA number. 
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3. 


Box the product in the original 
shipping container or other secure 
package. Write your MRA number on 
the top of the box. For all 
warranty repairs, enclose a copy of 
the original purchase receipt as 
proof of date of purchase. 


Ship by the most economical means 
tos 


IDEAssociates, Inc. 
35 Dunham Road 
Billerica, MA 81821 
Attn: MR No. 


When you ship this product, you agree 
to insure the product Or assume risk of 
loss or damage in transit and to 
prepare shipping charges to the 
factory. 


Once your product has been repaired, 

IDEA will return it to you by UPS or 

the most economical carrier at IDEA's 
expense. 
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Warranty Card 
Please complete and promptly return the 
enclosed warranty card. The warranty 


card should be filed by the party who 
installs the IDEA product. 


Limited Warranty 


For IDEAssociates' Limited Warranty, 
see the first page of this manual. 
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